@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.
- package/index.js +853 -661
- 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
|
-
|
|
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 (
|
|
1063
|
-
|
|
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
|
-
|
|
1074
|
-
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
5249
|
-
deferConversion:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
5503
|
+
icon: z3.string().optional().describe(
|
|
5316
5504
|
"New icon identifier for visual display (e.g., 'rocket', 'star', 'folder')."
|
|
5317
5505
|
),
|
|
5318
|
-
color:
|
|
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:
|
|
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:
|
|
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:
|
|
5580
|
+
thinkingLevel: z3.enum(["none", "low", "medium", "high"]).describe(
|
|
5393
5581
|
"Recommended thinking level for the model."
|
|
5394
5582
|
),
|
|
5395
|
-
reason:
|
|
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:
|
|
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:
|
|
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:
|
|
5639
|
+
thinkingLevel: z3.enum(["none", "low", "medium", "high"]).describe(
|
|
5452
5640
|
"Thinking level that was actually used."
|
|
5453
5641
|
),
|
|
5454
|
-
justification:
|
|
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
|
|
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:
|
|
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:
|
|
5587
|
-
description:
|
|
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:
|
|
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:
|
|
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:
|
|
5597
|
-
problemStatement:
|
|
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:
|
|
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:
|
|
5791
|
+
impactAssessment: z4.string().min(1).max(1e6).describe(
|
|
5604
5792
|
"Expected impact and benefits of implementing this epic (required)"
|
|
5605
5793
|
),
|
|
5606
|
-
targetAudience:
|
|
5794
|
+
targetAudience: z4.string().max(1e6).optional().describe(
|
|
5607
5795
|
"Who will benefit from this epic - users, teams, etc. (optional)"
|
|
5608
5796
|
),
|
|
5609
|
-
successMetrics:
|
|
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:
|
|
5800
|
+
alternatives: z4.string().max(1e6).optional().describe(
|
|
5613
5801
|
"Alternative approaches considered (optional)"
|
|
5614
5802
|
),
|
|
5615
|
-
dependencies:
|
|
5803
|
+
dependencies: z4.string().max(1e6).optional().describe(
|
|
5616
5804
|
"External dependencies or prerequisites (optional)"
|
|
5617
5805
|
),
|
|
5618
|
-
estimatedEffort:
|
|
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:
|
|
5812
|
+
originatingTicketUrl: z4.preprocess(
|
|
5625
5813
|
(value) => typeof value === "string" ? value.trim() : value,
|
|
5626
|
-
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
5771
|
-
title:
|
|
5772
|
-
description:
|
|
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:
|
|
5776
|
-
problemStatement:
|
|
5777
|
-
proposedSolution:
|
|
5778
|
-
impactAssessment:
|
|
5779
|
-
targetAudience:
|
|
5780
|
-
successMetrics:
|
|
5781
|
-
alternatives:
|
|
5782
|
-
dependencies:
|
|
5783
|
-
estimatedEffort:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
5886
|
-
reactionType:
|
|
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:
|
|
5917
|
-
content:
|
|
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:
|
|
5948
|
-
cursor:
|
|
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:
|
|
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:
|
|
5983
|
-
direction:
|
|
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:
|
|
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:
|
|
6041
|
-
direction:
|
|
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:
|
|
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:
|
|
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:
|
|
6095
|
-
status:
|
|
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:
|
|
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:
|
|
6102
|
-
epicIdentifier:
|
|
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:
|
|
6106
|
-
overall:
|
|
6107
|
-
epicDescription:
|
|
6108
|
-
structure:
|
|
6109
|
-
detail:
|
|
6110
|
-
scoping:
|
|
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:
|
|
6113
|
-
message:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
6496
|
+
canParallelize: z5.boolean().optional().describe(
|
|
6309
6497
|
"Whether this feature can run alongside other features in parallel."
|
|
6310
6498
|
),
|
|
6311
|
-
parallelGroup:
|
|
6499
|
+
parallelGroup: z5.string().max(100).optional().describe(
|
|
6312
6500
|
"Group identifier for features that can run together in parallel."
|
|
6313
6501
|
),
|
|
6314
|
-
dependencies:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
6581
|
+
canParallelize: z5.boolean().optional().describe(
|
|
6394
6582
|
"Whether this feature can run alongside other features in parallel."
|
|
6395
6583
|
),
|
|
6396
|
-
parallelGroup:
|
|
6584
|
+
parallelGroup: z5.string().max(100).optional().describe(
|
|
6397
6585
|
"Group identifier for features that can run together in parallel."
|
|
6398
6586
|
),
|
|
6399
|
-
dependencies:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
6720
|
+
canParallelize: z6.boolean().optional().describe(
|
|
6533
6721
|
"Whether this task can run alongside other tasks in parallel."
|
|
6534
6722
|
),
|
|
6535
|
-
parallelGroup:
|
|
6723
|
+
parallelGroup: z6.string().max(100).optional().describe(
|
|
6536
6724
|
"Group identifier for tasks that can run together in parallel."
|
|
6537
6725
|
),
|
|
6538
|
-
dependencies:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
6799
|
+
assignee: z6.string().optional().describe(
|
|
6612
6800
|
"New assignee user ID (UUID) for the task."
|
|
6613
6801
|
),
|
|
6614
6802
|
// Execution metadata
|
|
6615
|
-
executionOrder:
|
|
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:
|
|
6806
|
+
canParallelize: z6.boolean().optional().describe(
|
|
6619
6807
|
"Whether this task can run alongside other tasks in parallel."
|
|
6620
6808
|
),
|
|
6621
|
-
parallelGroup:
|
|
6809
|
+
parallelGroup: z6.string().max(100).optional().describe(
|
|
6622
6810
|
"Group identifier for tasks that can run together in parallel."
|
|
6623
6811
|
),
|
|
6624
|
-
dependencies:
|
|
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:
|
|
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
|
|
6853
|
+
import { z as z7 } from "zod";
|
|
6666
6854
|
var listStatusesSchema = {
|
|
6667
|
-
team:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
6752
|
-
|
|
6753
|
-
action:
|
|
6754
|
-
id:
|
|
6755
|
-
afterId:
|
|
6756
|
-
beforeId:
|
|
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
|
-
|
|
6759
|
-
action:
|
|
6760
|
-
id:
|
|
6761
|
-
afterId:
|
|
6762
|
-
beforeId:
|
|
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
|
-
|
|
6765
|
-
action:
|
|
6766
|
-
id:
|
|
6767
|
-
afterId:
|
|
6768
|
-
beforeId:
|
|
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:
|
|
7026
|
+
id: z8.string().uuid().describe(
|
|
6839
7027
|
"The UUID of the epic to reorder."
|
|
6840
7028
|
),
|
|
6841
|
-
afterId:
|
|
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:
|
|
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:
|
|
7073
|
+
id: z8.string().uuid().describe(
|
|
6886
7074
|
"The UUID of the feature to reorder."
|
|
6887
7075
|
),
|
|
6888
|
-
afterId:
|
|
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:
|
|
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:
|
|
7120
|
+
id: z8.string().uuid().describe(
|
|
6933
7121
|
"The UUID of the task to reorder."
|
|
6934
7122
|
),
|
|
6935
|
-
afterId:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
7275
|
-
executionOrder:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
7542
|
+
id: z11.string().describe(
|
|
7355
7543
|
"The feature or task that is blocked. Accepts UUID or human-readable identifier."
|
|
7356
7544
|
),
|
|
7357
|
-
type:
|
|
7358
|
-
blockedById:
|
|
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:
|
|
7595
|
+
id: z11.string().describe(
|
|
7408
7596
|
"The feature or task to unblock. Accepts UUID or human-readable identifier."
|
|
7409
7597
|
),
|
|
7410
|
-
type:
|
|
7411
|
-
unblockedFromId:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
8555
|
-
|
|
8556
|
-
action:
|
|
8557
|
-
id:
|
|
8558
|
-
type:
|
|
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
|
-
|
|
8561
|
-
action:
|
|
8562
|
-
id:
|
|
8563
|
-
type:
|
|
8564
|
-
context:
|
|
8565
|
-
sessionId:
|
|
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
|
-
|
|
8568
|
-
action:
|
|
8569
|
-
id:
|
|
8570
|
-
type:
|
|
8571
|
-
noteType:
|
|
8572
|
-
content:
|
|
8573
|
-
sessionId:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
8964
|
+
type: z13.enum(["feature", "task", "epic"]).describe(
|
|
8777
8965
|
"Whether this is a 'feature', 'task', or 'epic'."
|
|
8778
8966
|
),
|
|
8779
|
-
context:
|
|
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:
|
|
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:
|
|
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:
|
|
9031
|
+
type: z13.enum(["feature", "task", "epic"]).describe(
|
|
8844
9032
|
"Whether this is a 'feature', 'task', or 'epic'."
|
|
8845
9033
|
),
|
|
8846
|
-
noteType:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
8933
|
-
|
|
8934
|
-
action:
|
|
8935
|
-
id:
|
|
8936
|
-
type:
|
|
8937
|
-
sessionId:
|
|
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
|
-
|
|
8940
|
-
action:
|
|
8941
|
-
id:
|
|
8942
|
-
type:
|
|
8943
|
-
summary:
|
|
8944
|
-
sessionId:
|
|
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
|
-
|
|
8947
|
-
action:
|
|
8948
|
-
id:
|
|
8949
|
-
type:
|
|
8950
|
-
message:
|
|
8951
|
-
percentComplete:
|
|
8952
|
-
sessionId:
|
|
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
|
-
|
|
8955
|
-
action:
|
|
8956
|
-
id:
|
|
8957
|
-
type:
|
|
8958
|
-
reason:
|
|
8959
|
-
blockedById:
|
|
8960
|
-
sessionId:
|
|
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
|
-
|
|
8963
|
-
action:
|
|
8964
|
-
id:
|
|
8965
|
-
type:
|
|
8966
|
-
resolution:
|
|
8967
|
-
unblockedFromId:
|
|
8968
|
-
sessionId:
|
|
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:
|
|
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:
|
|
9270
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9083
9271
|
"Whether this is a 'feature' or 'task'."
|
|
9084
9272
|
),
|
|
9085
|
-
sessionId:
|
|
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:
|
|
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:
|
|
9310
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9123
9311
|
"Whether this is a 'feature' or 'task'."
|
|
9124
9312
|
),
|
|
9125
|
-
summary:
|
|
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:
|
|
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:
|
|
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:
|
|
9355
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9168
9356
|
"Whether this is a 'feature' or 'task'."
|
|
9169
9357
|
),
|
|
9170
|
-
message:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
9405
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9218
9406
|
"Whether this is a 'feature' or 'task'."
|
|
9219
9407
|
),
|
|
9220
|
-
reason:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
9329
|
-
epicName:
|
|
9330
|
-
variables:
|
|
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:
|
|
9379
|
-
epicName:
|
|
9380
|
-
team:
|
|
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:
|
|
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:
|
|
9387
|
-
epicIcon:
|
|
9388
|
-
epicColor:
|
|
9389
|
-
epicRequestId:
|
|
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:
|
|
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:
|
|
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:
|
|
9467
|
-
description:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
9724
|
+
inputSchema: z16.discriminatedUnion("action", [
|
|
9537
9725
|
// Action: get
|
|
9538
|
-
|
|
9539
|
-
action:
|
|
9726
|
+
z16.object({
|
|
9727
|
+
action: z16.literal("get"),
|
|
9540
9728
|
...baseSchema
|
|
9541
9729
|
}),
|
|
9542
9730
|
// Action: set
|
|
9543
|
-
|
|
9544
|
-
action:
|
|
9731
|
+
z16.object({
|
|
9732
|
+
action: z16.literal("set"),
|
|
9545
9733
|
...baseSchema,
|
|
9546
|
-
structuredDesc:
|
|
9547
|
-
summary:
|
|
9548
|
-
aiInstructions:
|
|
9549
|
-
acceptanceCriteria:
|
|
9550
|
-
filesInvolved:
|
|
9551
|
-
functionsToModify:
|
|
9552
|
-
testingStrategy:
|
|
9553
|
-
testFiles:
|
|
9554
|
-
relatedItemIds:
|
|
9555
|
-
externalLinks:
|
|
9556
|
-
url:
|
|
9557
|
-
title:
|
|
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:
|
|
9560
|
-
riskLevel:
|
|
9561
|
-
estimatedEffort:
|
|
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:
|
|
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
|
-
|
|
9569
|
-
action:
|
|
9756
|
+
z16.object({
|
|
9757
|
+
action: z16.literal("update_section"),
|
|
9570
9758
|
...baseSchema,
|
|
9571
|
-
section:
|
|
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:
|
|
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
|
-
|
|
9580
|
-
action:
|
|
9767
|
+
z16.object({
|
|
9768
|
+
action: z16.literal("add_criterion"),
|
|
9581
9769
|
...baseSchema,
|
|
9582
|
-
criterion:
|
|
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
|
-
|
|
9588
|
-
action:
|
|
9775
|
+
z16.object({
|
|
9776
|
+
action: z16.literal("link_file"),
|
|
9589
9777
|
...baseSchema,
|
|
9590
|
-
filePath:
|
|
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
|
-
|
|
9596
|
-
action:
|
|
9783
|
+
z16.object({
|
|
9784
|
+
action: z16.literal("add_link"),
|
|
9597
9785
|
...baseSchema,
|
|
9598
|
-
url:
|
|
9599
|
-
title:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
9867
|
-
structuredDesc:
|
|
9868
|
-
summary:
|
|
9869
|
-
aiInstructions:
|
|
9870
|
-
acceptanceCriteria:
|
|
9871
|
-
filesInvolved:
|
|
9872
|
-
functionsToModify:
|
|
9873
|
-
testingStrategy:
|
|
9874
|
-
testFiles:
|
|
9875
|
-
relatedItemIds:
|
|
9876
|
-
externalLinks:
|
|
9877
|
-
url:
|
|
9878
|
-
title:
|
|
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:
|
|
9881
|
-
riskLevel:
|
|
9882
|
-
estimatedEffort:
|
|
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:
|
|
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:
|
|
9946
|
-
section:
|
|
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:
|
|
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:
|
|
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:
|
|
10017
|
-
criterion:
|
|
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:
|
|
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:
|
|
10083
|
-
filePath:
|
|
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:
|
|
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:
|
|
10140
|
-
url:
|
|
10141
|
-
title:
|
|
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
|
|
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:
|
|
10387
|
+
inputSchema: z17.discriminatedUnion("action", [
|
|
10200
10388
|
// get_context action
|
|
10201
|
-
|
|
10202
|
-
action:
|
|
10203
|
-
id:
|
|
10204
|
-
type:
|
|
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
|
-
|
|
10208
|
-
action:
|
|
10209
|
-
id:
|
|
10210
|
-
type:
|
|
10211
|
-
filePath:
|
|
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
|
-
|
|
10215
|
-
action:
|
|
10216
|
-
id:
|
|
10217
|
-
type:
|
|
10218
|
-
filePath:
|
|
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
|
-
|
|
10222
|
-
action:
|
|
10223
|
-
id:
|
|
10224
|
-
type:
|
|
10225
|
-
filePath:
|
|
10226
|
-
functionName:
|
|
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
|
-
|
|
10230
|
-
action:
|
|
10231
|
-
id:
|
|
10232
|
-
type:
|
|
10233
|
-
branchName:
|
|
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
|
-
|
|
10237
|
-
action:
|
|
10238
|
-
id:
|
|
10239
|
-
type:
|
|
10240
|
-
commitSha:
|
|
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
|
-
|
|
10244
|
-
action:
|
|
10245
|
-
id:
|
|
10246
|
-
type:
|
|
10247
|
-
prNumber:
|
|
10248
|
-
prUrl:
|
|
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:
|
|
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:
|
|
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:
|
|
10636
|
+
id: z17.string().describe(
|
|
10449
10637
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10450
10638
|
),
|
|
10451
|
-
type:
|
|
10452
|
-
filePath:
|
|
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:
|
|
10674
|
+
id: z17.string().describe(
|
|
10487
10675
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10488
10676
|
),
|
|
10489
|
-
type:
|
|
10490
|
-
filePath:
|
|
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:
|
|
10712
|
+
id: z17.string().describe(
|
|
10525
10713
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10526
10714
|
),
|
|
10527
|
-
type:
|
|
10528
|
-
filePath:
|
|
10529
|
-
functionName:
|
|
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:
|
|
10759
|
+
id: z17.string().describe(
|
|
10572
10760
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10573
10761
|
),
|
|
10574
|
-
type:
|
|
10575
|
-
branchName:
|
|
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:
|
|
10797
|
+
id: z17.string().describe(
|
|
10610
10798
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10611
10799
|
),
|
|
10612
|
-
type:
|
|
10613
|
-
commitSha:
|
|
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:
|
|
10835
|
+
id: z17.string().describe(
|
|
10648
10836
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10649
10837
|
),
|
|
10650
|
-
type:
|
|
10651
|
-
prNumber:
|
|
10652
|
-
prUrl:
|
|
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
|
|
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:
|
|
10893
|
+
inputSchema: z18.discriminatedUnion("action", [
|
|
10706
10894
|
// Add validation
|
|
10707
|
-
|
|
10708
|
-
action:
|
|
10709
|
-
taskId:
|
|
10710
|
-
type:
|
|
10711
|
-
description:
|
|
10712
|
-
command:
|
|
10713
|
-
expectedExitCode:
|
|
10714
|
-
timeoutMs:
|
|
10715
|
-
filePath:
|
|
10716
|
-
searchPattern:
|
|
10717
|
-
testCommand:
|
|
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
|
-
|
|
10721
|
-
action:
|
|
10722
|
-
taskId:
|
|
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
|
-
|
|
10726
|
-
action:
|
|
10727
|
-
taskId:
|
|
10728
|
-
checkId:
|
|
10729
|
-
workingDirectory:
|
|
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
|
-
|
|
10733
|
-
action:
|
|
10734
|
-
taskId:
|
|
10735
|
-
stopOnFailure:
|
|
10736
|
-
workingDirectory:
|
|
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
|
-
|
|
10740
|
-
action:
|
|
10741
|
-
taskId:
|
|
10742
|
-
checkId:
|
|
10743
|
-
notes:
|
|
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
|
-
|
|
10747
|
-
action:
|
|
10748
|
-
taskId:
|
|
10749
|
-
checkId:
|
|
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
|
-
|
|
10753
|
-
action:
|
|
10754
|
-
taskId:
|
|
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:
|
|
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:
|
|
11035
|
+
type: z18.enum(validationCheckTypes).describe(
|
|
10848
11036
|
"The type of validation check."
|
|
10849
11037
|
),
|
|
10850
|
-
description:
|
|
11038
|
+
description: z18.string().min(1).max(500).describe(
|
|
10851
11039
|
"Human-readable description of what this check validates."
|
|
10852
11040
|
),
|
|
10853
|
-
command:
|
|
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:
|
|
11044
|
+
expectedExitCode: z18.number().int().min(0).max(255).optional().describe(
|
|
10857
11045
|
"Expected exit code for command (default: 0)."
|
|
10858
11046
|
),
|
|
10859
|
-
timeoutMs:
|
|
11047
|
+
timeoutMs: z18.number().int().min(1e3).max(3e5).optional().describe(
|
|
10860
11048
|
"Timeout in milliseconds (default: 30000, max: 300000)."
|
|
10861
11049
|
),
|
|
10862
|
-
filePath:
|
|
11050
|
+
filePath: z18.string().max(500).optional().describe(
|
|
10863
11051
|
"File path for 'file_exists' or 'file_contains' checks."
|
|
10864
11052
|
),
|
|
10865
|
-
searchPattern:
|
|
11053
|
+
searchPattern: z18.string().max(1e3).optional().describe(
|
|
10866
11054
|
"Regex pattern for 'file_contains' check."
|
|
10867
11055
|
),
|
|
10868
|
-
testCommand:
|
|
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:
|
|
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:
|
|
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:
|
|
11120
|
+
checkId: z18.string().uuid().describe(
|
|
10933
11121
|
"The ID of the validation check to run."
|
|
10934
11122
|
),
|
|
10935
|
-
workingDirectory:
|
|
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:
|
|
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:
|
|
11154
|
+
stopOnFailure: z18.boolean().optional().describe(
|
|
10967
11155
|
"If true, stops running checks after the first failure (default: false)."
|
|
10968
11156
|
),
|
|
10969
|
-
workingDirectory:
|
|
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:
|
|
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:
|
|
11187
|
+
checkId: z18.string().uuid().describe(
|
|
11000
11188
|
"The ID of the manual validation check to mark as validated."
|
|
11001
11189
|
),
|
|
11002
|
-
notes:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
11450
|
+
featureId: z20.string().uuid().optional().describe(
|
|
11263
11451
|
"Filter by feature ID. Returns decisions associated with this feature."
|
|
11264
11452
|
),
|
|
11265
|
-
taskId:
|
|
11453
|
+
taskId: z20.string().uuid().optional().describe(
|
|
11266
11454
|
"Filter by task ID. Returns decisions associated with this task."
|
|
11267
11455
|
),
|
|
11268
|
-
category:
|
|
11456
|
+
category: z20.enum(decisionCategories).optional().describe(
|
|
11269
11457
|
"Filter by decision category (architecture, library, approach, scope, design, tradeoff, deferral)."
|
|
11270
11458
|
),
|
|
11271
|
-
impact:
|
|
11459
|
+
impact: z20.enum(impactLevels).optional().describe(
|
|
11272
11460
|
"Filter by impact level (low, medium, high)."
|
|
11273
11461
|
),
|
|
11274
|
-
limit:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
11684
|
+
import { z as z22 } from "zod";
|
|
11497
11685
|
var createTeamChildSchema = {
|
|
11498
|
-
parentId:
|
|
11499
|
-
name:
|
|
11500
|
-
key:
|
|
11501
|
-
level:
|
|
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:
|
|
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:
|
|
11508
|
-
newParentId:
|
|
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
|
|
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 =
|
|
11635
|
-
url:
|
|
11636
|
-
title:
|
|
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 =
|
|
11639
|
-
summary:
|
|
11640
|
-
aiInstructions:
|
|
11641
|
-
acceptanceCriteria:
|
|
11642
|
-
filesInvolved:
|
|
11643
|
-
functionsToModify:
|
|
11644
|
-
testingStrategy:
|
|
11645
|
-
testFiles:
|
|
11646
|
-
relatedItemIds:
|
|
11647
|
-
externalLinks:
|
|
11648
|
-
technicalNotes:
|
|
11649
|
-
riskLevel:
|
|
11650
|
-
estimatedEffort:
|
|
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 =
|
|
11653
|
-
title:
|
|
11654
|
-
executionOrder:
|
|
11655
|
-
estimatedComplexity:
|
|
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 =
|
|
11659
|
-
title:
|
|
11660
|
-
executionOrder:
|
|
11661
|
-
estimatedComplexity:
|
|
11662
|
-
canParallelize:
|
|
11663
|
-
parallelGroup:
|
|
11664
|
-
dependencies:
|
|
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:
|
|
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:
|
|
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:
|
|
11699
|
-
team:
|
|
11700
|
-
description:
|
|
11701
|
-
icon:
|
|
11702
|
-
color:
|
|
11703
|
-
epicRequestId:
|
|
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:
|
|
11707
|
-
deferConversion:
|
|
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:
|
|
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: ${
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
12179
|
-
projectRoot:
|
|
12370
|
+
inputSchema: z25.object({
|
|
12371
|
+
projectRoot: z25.string().optional().describe(
|
|
12180
12372
|
"Project root directory (default: current working directory)"
|
|
12181
12373
|
),
|
|
12182
|
-
epicRequestId:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
12452
|
+
until: z26.string().optional().describe(
|
|
12261
12453
|
"Filter changes before this date (optional). Accepts ISO-8601 date format."
|
|
12262
12454
|
),
|
|
12263
|
-
limit:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
12575
|
+
externalId: z27.string().optional().describe(
|
|
12384
12576
|
"Optional external session identifier (e.g., from Copilot or another AI tool)."
|
|
12385
12577
|
),
|
|
12386
|
-
featureId:
|
|
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:
|
|
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:
|
|
12418
|
-
nextSteps:
|
|
12419
|
-
blockers:
|
|
12420
|
-
decisions:
|
|
12421
|
-
|
|
12422
|
-
decision:
|
|
12423
|
-
rationale:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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
|
|
12834
|
+
import { z as z31 } from "zod";
|
|
12643
12835
|
|
|
12644
12836
|
// src/tools/skill-packs/get-manifest.ts
|
|
12645
|
-
import { z as
|
|
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:
|
|
12844
|
+
id: z29.string().describe(
|
|
12653
12845
|
"Skill pack ID or name (e.g., '@mycompbox/planning' or UUID)"
|
|
12654
12846
|
),
|
|
12655
|
-
version:
|
|
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
|
|
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:
|
|
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:
|
|
12948
|
-
action:
|
|
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:
|
|
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:
|
|
12955
|
-
limit:
|
|
12956
|
-
isOfficial:
|
|
12957
|
-
query:
|
|
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:
|
|
13151
|
+
includeVersions: z31.boolean().optional().describe("Include all versions in response (get action only)"),
|
|
12960
13152
|
// Used by: install, update
|
|
12961
|
-
version:
|
|
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.
|
|
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"]) {
|