@mycompbox/compbox-mcp 1.21.12 → 1.21.14
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 +820 -646
- 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
|
});
|
|
@@ -904,6 +904,11 @@ var init_interview_completion = __esm({
|
|
|
904
904
|
});
|
|
905
905
|
|
|
906
906
|
// ../shared/dist/interview-conversation.js
|
|
907
|
+
function contentText(content) {
|
|
908
|
+
if (typeof content === "string")
|
|
909
|
+
return content;
|
|
910
|
+
return content.flatMap((b) => b.type === "text" && typeof b.text === "string" ? [b.text] : []).join("\n\n");
|
|
911
|
+
}
|
|
907
912
|
function requestLockReason(saved) {
|
|
908
913
|
if (!saved)
|
|
909
914
|
return null;
|
|
@@ -953,6 +958,10 @@ What a good request covers:
|
|
|
953
958
|
${definition.map(renderSection).join("\n")}
|
|
954
959
|
Optional topics may be skipped when the person has nothing to add. Never invent or pad facts.
|
|
955
960
|
|
|
961
|
+
What you can and can't do:
|
|
962
|
+
- 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.
|
|
963
|
+
- 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.
|
|
964
|
+
|
|
956
965
|
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
966
|
\`\`\`json
|
|
958
967
|
{"done": true, ${shape}}
|
|
@@ -976,7 +985,7 @@ function toConversationMessages(turns) {
|
|
|
976
985
|
return messages;
|
|
977
986
|
}
|
|
978
987
|
function renderConversationPrompt(messages) {
|
|
979
|
-
const lines = messages.map((m) => `${m.role === "assistant" ? "You" : "Them"}: ${m.content}`);
|
|
988
|
+
const lines = messages.map((m) => `${m.role === "assistant" ? "You" : "Them"}: ${contentText(m.content)}`);
|
|
980
989
|
return `The conversation so far:
|
|
981
990
|
|
|
982
991
|
${lines.join("\n\n")}
|
|
@@ -2835,6 +2844,156 @@ var init_needs_input = __esm({
|
|
|
2835
2844
|
}
|
|
2836
2845
|
});
|
|
2837
2846
|
|
|
2847
|
+
// ../shared/dist/idea-stage.js
|
|
2848
|
+
function isActive(job) {
|
|
2849
|
+
return !!job && !ENDED.has(job.status);
|
|
2850
|
+
}
|
|
2851
|
+
function isAsking(job) {
|
|
2852
|
+
return isActive(job) && job.status === "waiting" && job.waitingReason === "needs_input";
|
|
2853
|
+
}
|
|
2854
|
+
function epicIdFromPlanning(planningState) {
|
|
2855
|
+
if (!planningState)
|
|
2856
|
+
return null;
|
|
2857
|
+
if (typeof planningState !== "string")
|
|
2858
|
+
return planningState.epicId ?? null;
|
|
2859
|
+
try {
|
|
2860
|
+
const parsed = JSON.parse(planningState);
|
|
2861
|
+
return typeof parsed?.epicId === "string" ? parsed.epicId : null;
|
|
2862
|
+
} catch {
|
|
2863
|
+
return null;
|
|
2864
|
+
}
|
|
2865
|
+
}
|
|
2866
|
+
function stageOf(facts) {
|
|
2867
|
+
const { request, epic, planJob, buildJob } = facts;
|
|
2868
|
+
if (request.status === "rejected")
|
|
2869
|
+
return { stage: "idea", closed: true, needsYou: null };
|
|
2870
|
+
const display = epic?.displayState ?? null;
|
|
2871
|
+
const openPrs = facts.openPullRequests ?? 0;
|
|
2872
|
+
const hasEpic = !!(request.convertedEpicId ?? epicIdFromPlanning(request.planningState)) || !!epic;
|
|
2873
|
+
const stillWorking = isActive(buildJob) || openPrs > 0 || display !== null && BUILD_DISPLAY.has(display);
|
|
2874
|
+
const partsLeft = typeof epic?.featureCount === "number" ? Math.max(0, epic.featureCount - (epic.completedFeatureCount ?? 0)) : 0;
|
|
2875
|
+
const merged = display === "merged" || epic?.buildPullRequestState === "merged";
|
|
2876
|
+
const finished = epic?.state === "implemented" || merged && partsLeft === 0;
|
|
2877
|
+
const done = finished && !stillWorking;
|
|
2878
|
+
const building = stillWorking || merged || (epic?.completedFeatureCount ?? 0) > 0;
|
|
2879
|
+
let stage;
|
|
2880
|
+
if (done)
|
|
2881
|
+
stage = "done";
|
|
2882
|
+
else if (building)
|
|
2883
|
+
stage = "build";
|
|
2884
|
+
else if (request.status !== "pending" || hasEpic || isActive(planJob))
|
|
2885
|
+
stage = "blueprint";
|
|
2886
|
+
else
|
|
2887
|
+
stage = "idea";
|
|
2888
|
+
return { stage, closed: false, needsYou: done ? null : needsYouOf(facts, hasEpic, openPrs, display) };
|
|
2889
|
+
}
|
|
2890
|
+
function needsYouOf(facts, hasEpic, openPrs, display) {
|
|
2891
|
+
const { request, planJob, buildJob } = facts;
|
|
2892
|
+
if (facts.interviewJobStatus === "awaiting_input")
|
|
2893
|
+
return "answer_idea_helper";
|
|
2894
|
+
if (isAsking(buildJob))
|
|
2895
|
+
return MERGE_KINDS.has(buildJob?.needsInput?.kind ?? "") ? "merge_prs" : "answer_builder";
|
|
2896
|
+
if (isAsking(planJob))
|
|
2897
|
+
return "answer_blueprint_maker";
|
|
2898
|
+
const buildWorking = isActive(buildJob) && buildJob.status !== "waiting";
|
|
2899
|
+
if (openPrs > 0 && !buildWorking)
|
|
2900
|
+
return "merge_prs";
|
|
2901
|
+
if (display === "needs_decision" || display === "failed")
|
|
2902
|
+
return "decide_build";
|
|
2903
|
+
if (display === "ready")
|
|
2904
|
+
return "review_build";
|
|
2905
|
+
if (request.status === "approved" && !hasEpic && !isActive(planJob))
|
|
2906
|
+
return "make_blueprint";
|
|
2907
|
+
return null;
|
|
2908
|
+
}
|
|
2909
|
+
var ENDED, BUILD_DISPLAY, MERGE_KINDS;
|
|
2910
|
+
var init_idea_stage = __esm({
|
|
2911
|
+
"../shared/dist/idea-stage.js"() {
|
|
2912
|
+
"use strict";
|
|
2913
|
+
ENDED = /* @__PURE__ */ new Set(["done", "failed", "cancelled"]);
|
|
2914
|
+
BUILD_DISPLAY = /* @__PURE__ */ new Set(["running", "ready", "needs_decision", "failed", "follow_up"]);
|
|
2915
|
+
MERGE_KINDS = /* @__PURE__ */ new Set(["merge_approval", "merge_prs"]);
|
|
2916
|
+
}
|
|
2917
|
+
});
|
|
2918
|
+
|
|
2919
|
+
// ../shared/dist/run-progress.js
|
|
2920
|
+
import { z as z2 } from "zod";
|
|
2921
|
+
var isoTimestamp, runKindSchema, runStageStatusSchema, runStateSchema, runProgressStageSchema, runEtaSchema, runProgressBaseSchema, runProgressSchema;
|
|
2922
|
+
var init_run_progress = __esm({
|
|
2923
|
+
"../shared/dist/run-progress.js"() {
|
|
2924
|
+
"use strict";
|
|
2925
|
+
isoTimestamp = z2.string().datetime({ offset: true });
|
|
2926
|
+
runKindSchema = z2.enum(["planning", "build"]);
|
|
2927
|
+
runStageStatusSchema = z2.enum(["pending", "active", "completed", "failed", "skipped"]);
|
|
2928
|
+
runStateSchema = z2.enum([
|
|
2929
|
+
"pending",
|
|
2930
|
+
"active",
|
|
2931
|
+
"completed",
|
|
2932
|
+
"failed",
|
|
2933
|
+
"cancelled",
|
|
2934
|
+
"stalled"
|
|
2935
|
+
]);
|
|
2936
|
+
runProgressStageSchema = z2.object({
|
|
2937
|
+
/** Stable machine key for the stage, unique within the run. */
|
|
2938
|
+
key: z2.string().min(1),
|
|
2939
|
+
/** Human-readable label shown in the UI. */
|
|
2940
|
+
label: z2.string().min(1),
|
|
2941
|
+
/** Current status of the stage. */
|
|
2942
|
+
status: runStageStatusSchema,
|
|
2943
|
+
/** Optional short detail line (for example "3 of 7 tasks"). */
|
|
2944
|
+
detail: z2.string().nullable(),
|
|
2945
|
+
/** When the stage started, or null if it has not started yet. */
|
|
2946
|
+
startedAt: isoTimestamp.nullable(),
|
|
2947
|
+
/** When the stage finished, or null if it has not finished yet. */
|
|
2948
|
+
completedAt: isoTimestamp.nullable()
|
|
2949
|
+
});
|
|
2950
|
+
runEtaSchema = z2.object({
|
|
2951
|
+
/** Estimated seconds left, or null when no estimate can be made. */
|
|
2952
|
+
secondsRemaining: z2.number().int().nonnegative().nullable(),
|
|
2953
|
+
/** How much to trust the estimate, based mostly on sample size. */
|
|
2954
|
+
confidence: z2.enum(["low", "medium", "high"]),
|
|
2955
|
+
/** Number of past runs the estimate is based on. */
|
|
2956
|
+
sampleSize: z2.number().int().nonnegative(),
|
|
2957
|
+
/** True when the run has already taken longer than the estimate. */
|
|
2958
|
+
overrun: z2.boolean()
|
|
2959
|
+
});
|
|
2960
|
+
runProgressBaseSchema = z2.object({
|
|
2961
|
+
// --- Identity ---
|
|
2962
|
+
/** Which kind of run this is. */
|
|
2963
|
+
runKind: runKindSchema,
|
|
2964
|
+
// --- Stages ---
|
|
2965
|
+
/** Ordered list of the run's stages. */
|
|
2966
|
+
stages: z2.array(runProgressStageSchema),
|
|
2967
|
+
/** Key of the stage currently running, or null if none is running. */
|
|
2968
|
+
currentStageKey: z2.string().min(1).nullable(),
|
|
2969
|
+
// --- Counts ---
|
|
2970
|
+
/** Units of work finished (stages for planning, tasks for build). */
|
|
2971
|
+
completed: z2.number().int().nonnegative(),
|
|
2972
|
+
/** Total units of work in the run. */
|
|
2973
|
+
total: z2.number().int().nonnegative(),
|
|
2974
|
+
// --- State ---
|
|
2975
|
+
/** Overall state of the run. */
|
|
2976
|
+
state: runStateSchema,
|
|
2977
|
+
/** Why the run failed or stalled, or null otherwise. */
|
|
2978
|
+
failureReason: z2.string().nullable(),
|
|
2979
|
+
// --- Timing ---
|
|
2980
|
+
/** When the run started. */
|
|
2981
|
+
startedAt: isoTimestamp,
|
|
2982
|
+
/** When progress was last reported. */
|
|
2983
|
+
updatedAt: isoTimestamp,
|
|
2984
|
+
/** Estimated time remaining, or null when there is no estimate. */
|
|
2985
|
+
eta: runEtaSchema.nullable()
|
|
2986
|
+
});
|
|
2987
|
+
runProgressSchema = runProgressBaseSchema.refine((p) => p.completed <= p.total, {
|
|
2988
|
+
message: "completed must not be greater than total",
|
|
2989
|
+
path: ["completed"]
|
|
2990
|
+
}).refine((p) => p.currentStageKey === null || p.stages.some((s) => s.key === p.currentStageKey), {
|
|
2991
|
+
message: "currentStageKey must match one of the stage keys",
|
|
2992
|
+
path: ["currentStageKey"]
|
|
2993
|
+
});
|
|
2994
|
+
}
|
|
2995
|
+
});
|
|
2996
|
+
|
|
2838
2997
|
// ../shared/dist/index.js
|
|
2839
2998
|
var dist_exports = {};
|
|
2840
2999
|
__export(dist_exports, {
|
|
@@ -2904,6 +3063,7 @@ __export(dist_exports, {
|
|
|
2904
3063
|
cloudSqlInstanceName: () => cloudSqlInstanceName,
|
|
2905
3064
|
compareMachineVersions: () => compareMachineVersions,
|
|
2906
3065
|
complianceFromRecord: () => complianceFromRecord,
|
|
3066
|
+
contentText: () => contentText,
|
|
2907
3067
|
databaseSecretName: () => databaseSecretName,
|
|
2908
3068
|
deployRunTitle: () => deployRunTitle,
|
|
2909
3069
|
err: () => err,
|
|
@@ -2972,6 +3132,13 @@ __export(dist_exports, {
|
|
|
2972
3132
|
requestLockReason: () => requestLockReason,
|
|
2973
3133
|
resolveRouting: () => resolveRouting,
|
|
2974
3134
|
runConversationStep: () => runConversationStep,
|
|
3135
|
+
runEtaSchema: () => runEtaSchema,
|
|
3136
|
+
runKindSchema: () => runKindSchema,
|
|
3137
|
+
runProgressBaseSchema: () => runProgressBaseSchema,
|
|
3138
|
+
runProgressSchema: () => runProgressSchema,
|
|
3139
|
+
runProgressStageSchema: () => runProgressStageSchema,
|
|
3140
|
+
runStageStatusSchema: () => runStageStatusSchema,
|
|
3141
|
+
runStateSchema: () => runStateSchema,
|
|
2975
3142
|
safeReturnTo: () => safeReturnTo,
|
|
2976
3143
|
safeValidateSkillPackManifest: () => safeValidateSkillPackManifest,
|
|
2977
3144
|
savedContextFromRecord: () => savedContextFromRecord,
|
|
@@ -2983,6 +3150,7 @@ __export(dist_exports, {
|
|
|
2983
3150
|
stackAppName: () => stackAppName,
|
|
2984
3151
|
stackEnvSettings: () => stackEnvSettings,
|
|
2985
3152
|
stackEnvironments: () => stackEnvironments,
|
|
3153
|
+
stageOf: () => stageOf,
|
|
2986
3154
|
stripRunnerOnlyFields: () => stripRunnerOnlyFields,
|
|
2987
3155
|
teardownConfirmation: () => teardownConfirmation,
|
|
2988
3156
|
teardownRunTitle: () => teardownRunTitle,
|
|
@@ -3011,6 +3179,8 @@ var init_dist = __esm({
|
|
|
3011
3179
|
init_return_to();
|
|
3012
3180
|
init_machineVersion();
|
|
3013
3181
|
init_needs_input();
|
|
3182
|
+
init_idea_stage();
|
|
3183
|
+
init_run_progress();
|
|
3014
3184
|
}
|
|
3015
3185
|
});
|
|
3016
3186
|
|
|
@@ -3021,7 +3191,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
|
|
|
3021
3191
|
|
|
3022
3192
|
// src/tools/epics.ts
|
|
3023
3193
|
init_dist();
|
|
3024
|
-
import { z as
|
|
3194
|
+
import { z as z3 } from "zod";
|
|
3025
3195
|
|
|
3026
3196
|
// src/api-client.ts
|
|
3027
3197
|
var ApiError = class extends Error {
|
|
@@ -4996,22 +5166,22 @@ function registerEpicTools(server2) {
|
|
|
4996
5166
|
{
|
|
4997
5167
|
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
5168
|
inputSchema: {
|
|
4999
|
-
scope:
|
|
5169
|
+
scope: z3.enum(["personal", "team", "all"]).optional().describe(
|
|
5000
5170
|
"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
5171
|
),
|
|
5002
|
-
team:
|
|
5172
|
+
team: z3.string().optional().describe(
|
|
5003
5173
|
"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
5174
|
),
|
|
5005
|
-
includeArchived:
|
|
5175
|
+
includeArchived: z3.boolean().optional().describe(
|
|
5006
5176
|
"Include archived epics in results. When false (default), only active epics are returned. Set to true to see all epics including archived ones."
|
|
5007
5177
|
),
|
|
5008
|
-
state:
|
|
5178
|
+
state: z3.enum(["active", "implemented", "archived"]).optional().describe(
|
|
5009
5179
|
"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
5180
|
),
|
|
5011
|
-
limit:
|
|
5181
|
+
limit: z3.number().int().min(1).max(100).optional().describe(
|
|
5012
5182
|
"Maximum number of epics to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
|
|
5013
5183
|
),
|
|
5014
|
-
cursor:
|
|
5184
|
+
cursor: z3.string().optional().describe(
|
|
5015
5185
|
"Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
|
|
5016
5186
|
)
|
|
5017
5187
|
}
|
|
@@ -5156,7 +5326,7 @@ function registerEpicTools(server2) {
|
|
|
5156
5326
|
{
|
|
5157
5327
|
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
5328
|
inputSchema: {
|
|
5159
|
-
query:
|
|
5329
|
+
query: z3.string().describe(
|
|
5160
5330
|
"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
5331
|
)
|
|
5162
5332
|
}
|
|
@@ -5227,26 +5397,26 @@ function registerEpicTools(server2) {
|
|
|
5227
5397
|
|
|
5228
5398
|
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
5399
|
inputSchema: {
|
|
5230
|
-
name:
|
|
5400
|
+
name: z3.string().min(1).describe(
|
|
5231
5401
|
"The display name for the epic (required). Should be descriptive and unique within the team (e.g., 'Q1 2024 Features', 'Mobile App Redesign')."
|
|
5232
5402
|
),
|
|
5233
|
-
team:
|
|
5403
|
+
team: z3.string().describe(
|
|
5234
5404
|
"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
5405
|
),
|
|
5236
|
-
description:
|
|
5406
|
+
description: z3.string().max(DESCRIPTION_MAX).optional().describe(
|
|
5237
5407
|
"A longer description of the epic's purpose and scope. Supports plain text (e.g., 'Features for the mobile app redesign initiative')."
|
|
5238
5408
|
),
|
|
5239
|
-
icon:
|
|
5409
|
+
icon: z3.string().optional().describe(
|
|
5240
5410
|
"An icon identifier for visual display (e.g., 'rocket', 'star', 'folder'). Used in the UI to help identify the epic at a glance."
|
|
5241
5411
|
),
|
|
5242
|
-
color:
|
|
5412
|
+
color: z3.string().optional().describe(
|
|
5243
5413
|
"A hex color code for the epic's visual theme (e.g., '#FF5733', '#3B82F6'). Used in the UI for epic badges and highlights."
|
|
5244
5414
|
),
|
|
5245
|
-
epicRequestId:
|
|
5415
|
+
epicRequestId: z3.string().uuid().optional().describe(
|
|
5246
5416
|
"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
5417
|
),
|
|
5248
|
-
bypassGovernance:
|
|
5249
|
-
deferConversion:
|
|
5418
|
+
bypassGovernance: z3.boolean().optional(),
|
|
5419
|
+
deferConversion: z3.boolean().optional().describe(
|
|
5250
5420
|
"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
5421
|
)
|
|
5252
5422
|
}
|
|
@@ -5300,22 +5470,22 @@ Create a new epic in CompBox. An epic is a container for features and must belon
|
|
|
5300
5470
|
{
|
|
5301
5471
|
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
5472
|
inputSchema: {
|
|
5303
|
-
id:
|
|
5473
|
+
id: z3.string().describe(
|
|
5304
5474
|
"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
5475
|
),
|
|
5306
|
-
name:
|
|
5476
|
+
name: z3.string().min(1).optional().describe(
|
|
5307
5477
|
"New name for the epic. Only provide if you want to change the name."
|
|
5308
5478
|
),
|
|
5309
|
-
description:
|
|
5479
|
+
description: z3.string().max(DESCRIPTION_MAX).optional().describe(
|
|
5310
5480
|
"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
5481
|
),
|
|
5312
|
-
appendToDescription:
|
|
5482
|
+
appendToDescription: z3.string().max(APPEND_DESCRIPTION_MAX).optional().describe(
|
|
5313
5483
|
"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
5484
|
),
|
|
5315
|
-
icon:
|
|
5485
|
+
icon: z3.string().optional().describe(
|
|
5316
5486
|
"New icon identifier for visual display (e.g., 'rocket', 'star', 'folder')."
|
|
5317
5487
|
),
|
|
5318
|
-
color:
|
|
5488
|
+
color: z3.string().optional().describe(
|
|
5319
5489
|
"New hex color code for the epic's visual theme (e.g., '#FF5733', '#3B82F6')."
|
|
5320
5490
|
)
|
|
5321
5491
|
}
|
|
@@ -5383,16 +5553,16 @@ Create a new epic in CompBox. An epic is a container for features and must belon
|
|
|
5383
5553
|
{
|
|
5384
5554
|
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
5555
|
inputSchema: {
|
|
5386
|
-
epicId:
|
|
5556
|
+
epicId: z3.string().describe(
|
|
5387
5557
|
"The epic to set recommendation for. Accepts UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
5388
5558
|
),
|
|
5389
|
-
model:
|
|
5559
|
+
model: z3.string().describe(
|
|
5390
5560
|
"Model ID from the catalog (e.g., 'claude-sonnet-4.6', 'claude-opus-4.6', 'gpt-5.5')."
|
|
5391
5561
|
),
|
|
5392
|
-
thinkingLevel:
|
|
5562
|
+
thinkingLevel: z3.enum(["none", "low", "medium", "high"]).describe(
|
|
5393
5563
|
"Recommended thinking level for the model."
|
|
5394
5564
|
),
|
|
5395
|
-
reason:
|
|
5565
|
+
reason: z3.string().min(1).max(2e3).describe(
|
|
5396
5566
|
"1-2 sentence rationale for the model recommendation (e.g., 'Complex multi-file refactoring requiring deep reasoning')."
|
|
5397
5567
|
)
|
|
5398
5568
|
}
|
|
@@ -5442,16 +5612,16 @@ Create a new epic in CompBox. An epic is a container for features and must belon
|
|
|
5442
5612
|
{
|
|
5443
5613
|
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
5614
|
inputSchema: {
|
|
5445
|
-
epicId:
|
|
5615
|
+
epicId: z3.string().describe(
|
|
5446
5616
|
"The epic to record model usage for. Accepts UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
5447
5617
|
),
|
|
5448
|
-
model:
|
|
5618
|
+
model: z3.string().describe(
|
|
5449
5619
|
"Model ID that was actually used (e.g., 'claude-sonnet-4.6', 'claude-opus-4.6', 'gpt-5.5')."
|
|
5450
5620
|
),
|
|
5451
|
-
thinkingLevel:
|
|
5621
|
+
thinkingLevel: z3.enum(["none", "low", "medium", "high"]).describe(
|
|
5452
5622
|
"Thinking level that was actually used."
|
|
5453
5623
|
),
|
|
5454
|
-
justification:
|
|
5624
|
+
justification: z3.string().trim().min(10).max(5e3).optional().describe(
|
|
5455
5625
|
"Required when the model used differs from the recommended model. Explain why a different model was chosen (e.g., cost, availability, task complexity)."
|
|
5456
5626
|
)
|
|
5457
5627
|
}
|
|
@@ -5508,14 +5678,14 @@ Create a new epic in CompBox. An epic is a container for features and must belon
|
|
|
5508
5678
|
}
|
|
5509
5679
|
|
|
5510
5680
|
// src/tools/epic-requests.ts
|
|
5511
|
-
import { z as
|
|
5681
|
+
import { z as z4 } from "zod";
|
|
5512
5682
|
function registerEpicRequestTools(server2) {
|
|
5513
5683
|
server2.registerTool(
|
|
5514
5684
|
"compbox__draft_epic_request",
|
|
5515
5685
|
{
|
|
5516
5686
|
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
5687
|
inputSchema: {
|
|
5518
|
-
template:
|
|
5688
|
+
template: z4.string().optional().describe(
|
|
5519
5689
|
"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
5690
|
)
|
|
5521
5691
|
}
|
|
@@ -5583,47 +5753,47 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5583
5753
|
// vice-versa.
|
|
5584
5754
|
// -----------------------------------------------------------------------
|
|
5585
5755
|
inputSchema: {
|
|
5586
|
-
title:
|
|
5587
|
-
description:
|
|
5756
|
+
title: z4.string().min(1).max(500).describe("Title of the epic request (required, max 500 chars)"),
|
|
5757
|
+
description: z4.string().max(1e6).optional().describe(
|
|
5588
5758
|
"Plain markdown description of the epic request (optional)"
|
|
5589
5759
|
),
|
|
5590
|
-
scope:
|
|
5760
|
+
scope: z4.enum(["personal", "team"]).optional().describe(
|
|
5591
5761
|
"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
5762
|
),
|
|
5593
|
-
teamId:
|
|
5763
|
+
teamId: z4.string().uuid().optional().describe(
|
|
5594
5764
|
"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
5765
|
),
|
|
5596
|
-
structuredDesc:
|
|
5597
|
-
problemStatement:
|
|
5766
|
+
structuredDesc: z4.object({
|
|
5767
|
+
problemStatement: z4.string().min(1).max(1e6).describe(
|
|
5598
5768
|
"Clear statement of the problem or opportunity this epic would address (required)"
|
|
5599
5769
|
),
|
|
5600
|
-
proposedSolution:
|
|
5770
|
+
proposedSolution: z4.string().min(1).max(1e6).describe(
|
|
5601
5771
|
"High-level description of how this epic would solve the problem (required)"
|
|
5602
5772
|
),
|
|
5603
|
-
impactAssessment:
|
|
5773
|
+
impactAssessment: z4.string().min(1).max(1e6).describe(
|
|
5604
5774
|
"Expected impact and benefits of implementing this epic (required)"
|
|
5605
5775
|
),
|
|
5606
|
-
targetAudience:
|
|
5776
|
+
targetAudience: z4.string().max(1e6).optional().describe(
|
|
5607
5777
|
"Who will benefit from this epic - users, teams, etc. (optional)"
|
|
5608
5778
|
),
|
|
5609
|
-
successMetrics:
|
|
5779
|
+
successMetrics: z4.string().max(1e6).optional().describe(
|
|
5610
5780
|
"How success will be measured if this epic is implemented (optional)"
|
|
5611
5781
|
),
|
|
5612
|
-
alternatives:
|
|
5782
|
+
alternatives: z4.string().max(1e6).optional().describe(
|
|
5613
5783
|
"Alternative approaches considered (optional)"
|
|
5614
5784
|
),
|
|
5615
|
-
dependencies:
|
|
5785
|
+
dependencies: z4.string().max(1e6).optional().describe(
|
|
5616
5786
|
"External dependencies or prerequisites (optional)"
|
|
5617
5787
|
),
|
|
5618
|
-
estimatedEffort:
|
|
5788
|
+
estimatedEffort: z4.string().max(1e6).optional().describe(
|
|
5619
5789
|
"Rough effort estimate, e.g., '2-3 weeks', '1 quarter' (optional)"
|
|
5620
5790
|
)
|
|
5621
5791
|
}).optional().describe(
|
|
5622
5792
|
"Structured description with detailed proposal information. If provided, problemStatement, proposedSolution, and impactAssessment are required."
|
|
5623
5793
|
),
|
|
5624
|
-
originatingTicketUrl:
|
|
5794
|
+
originatingTicketUrl: z4.preprocess(
|
|
5625
5795
|
(value) => typeof value === "string" ? value.trim() : value,
|
|
5626
|
-
|
|
5796
|
+
z4.string().url().max(2048)
|
|
5627
5797
|
).refine((value) => {
|
|
5628
5798
|
try {
|
|
5629
5799
|
const url = new URL(value);
|
|
@@ -5695,16 +5865,16 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5695
5865
|
{
|
|
5696
5866
|
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
5867
|
inputSchema: {
|
|
5698
|
-
cursor:
|
|
5868
|
+
cursor: z4.string().optional().describe(
|
|
5699
5869
|
"Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
|
|
5700
5870
|
),
|
|
5701
|
-
limit:
|
|
5871
|
+
limit: z4.number().int().min(1).max(100).optional().describe(
|
|
5702
5872
|
"Maximum number of epic requests to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
|
|
5703
5873
|
),
|
|
5704
|
-
status:
|
|
5874
|
+
status: z4.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
|
|
5705
5875
|
"Filter by request status: 'pending' (awaiting review), 'approved' (approved by admin), 'rejected' (rejected by admin), or 'converted' (already converted to epic)"
|
|
5706
5876
|
),
|
|
5707
|
-
requestedById:
|
|
5877
|
+
requestedById: z4.string().optional().describe(
|
|
5708
5878
|
"Filter by the user ID who created the request. Returns only requests created by this user."
|
|
5709
5879
|
)
|
|
5710
5880
|
}
|
|
@@ -5732,7 +5902,7 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5732
5902
|
{
|
|
5733
5903
|
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
5904
|
inputSchema: {
|
|
5735
|
-
id:
|
|
5905
|
+
id: z4.string().describe(
|
|
5736
5906
|
"The epic request to retrieve. Accepts UUID or identifier (e.g., 'ER-1'). Get this from list_epic_requests."
|
|
5737
5907
|
)
|
|
5738
5908
|
}
|
|
@@ -5767,27 +5937,27 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5767
5937
|
// vice-versa.
|
|
5768
5938
|
// -----------------------------------------------------------------------
|
|
5769
5939
|
inputSchema: {
|
|
5770
|
-
id:
|
|
5771
|
-
title:
|
|
5772
|
-
description:
|
|
5940
|
+
id: z4.string().describe("The epic request to update. Accepts UUID or identifier (e.g., 'ER-1')"),
|
|
5941
|
+
title: z4.string().min(1).max(500).optional().describe("New title for the epic request (optional, max 500 chars)"),
|
|
5942
|
+
description: z4.string().max(1e6).optional().describe(
|
|
5773
5943
|
"New plain markdown description (optional). This replaces the entire description."
|
|
5774
5944
|
),
|
|
5775
|
-
structuredDesc:
|
|
5776
|
-
problemStatement:
|
|
5777
|
-
proposedSolution:
|
|
5778
|
-
impactAssessment:
|
|
5779
|
-
targetAudience:
|
|
5780
|
-
successMetrics:
|
|
5781
|
-
alternatives:
|
|
5782
|
-
dependencies:
|
|
5783
|
-
estimatedEffort:
|
|
5945
|
+
structuredDesc: z4.object({
|
|
5946
|
+
problemStatement: z4.string().min(1).max(1e6).describe("Problem statement (required if structuredDesc provided)"),
|
|
5947
|
+
proposedSolution: z4.string().min(1).max(1e6).describe("Proposed solution (required if structuredDesc provided)"),
|
|
5948
|
+
impactAssessment: z4.string().min(1).max(1e6).describe("Impact assessment (required if structuredDesc provided)"),
|
|
5949
|
+
targetAudience: z4.string().max(1e6).optional().describe("Target audience (optional)"),
|
|
5950
|
+
successMetrics: z4.string().max(1e6).optional().describe("Success metrics (optional)"),
|
|
5951
|
+
alternatives: z4.string().max(1e6).optional().describe("Alternative approaches (optional)"),
|
|
5952
|
+
dependencies: z4.string().max(1e6).optional().describe("Dependencies (optional)"),
|
|
5953
|
+
estimatedEffort: z4.string().max(1e6).optional().describe("Estimated effort (optional)")
|
|
5784
5954
|
}).optional().describe(
|
|
5785
5955
|
"New structured description (optional). This replaces the entire structuredDesc."
|
|
5786
5956
|
),
|
|
5787
|
-
status:
|
|
5957
|
+
status: z4.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
|
|
5788
5958
|
"New status (optional, admin only). Use approve/reject endpoints instead when possible."
|
|
5789
5959
|
),
|
|
5790
|
-
convertedEpicId:
|
|
5960
|
+
convertedEpicId: z4.string().uuid().optional().describe(
|
|
5791
5961
|
"The ID of the epic created from this request. Set when transitioning to 'converted' status."
|
|
5792
5962
|
)
|
|
5793
5963
|
}
|
|
@@ -5849,7 +6019,7 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5849
6019
|
{
|
|
5850
6020
|
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
6021
|
inputSchema: {
|
|
5852
|
-
id:
|
|
6022
|
+
id: z4.string().describe("The epic request to delete. Accepts UUID or identifier (e.g., 'ER-1')")
|
|
5853
6023
|
}
|
|
5854
6024
|
},
|
|
5855
6025
|
async (input) => {
|
|
@@ -5882,8 +6052,8 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5882
6052
|
{
|
|
5883
6053
|
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
6054
|
inputSchema: {
|
|
5885
|
-
id:
|
|
5886
|
-
reactionType:
|
|
6055
|
+
id: z4.string().describe("The epic request to react to. Accepts UUID or identifier (e.g., 'ER-1')"),
|
|
6056
|
+
reactionType: z4.enum(["like", "fire", "dislike"]).describe(
|
|
5887
6057
|
"Type of reaction: 'like' (positive), 'fire' (excited/strong support), or 'dislike' (negative)"
|
|
5888
6058
|
)
|
|
5889
6059
|
}
|
|
@@ -5913,8 +6083,8 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5913
6083
|
{
|
|
5914
6084
|
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
6085
|
inputSchema: {
|
|
5916
|
-
id:
|
|
5917
|
-
content:
|
|
6086
|
+
id: z4.string().describe("The epic request to comment on. Accepts UUID or identifier (e.g., 'ER-1')"),
|
|
6087
|
+
content: z4.string().min(1).max(5e3).describe(
|
|
5918
6088
|
"Content of the comment (required, 1-5000 chars). Plain text only."
|
|
5919
6089
|
)
|
|
5920
6090
|
}
|
|
@@ -5944,11 +6114,11 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5944
6114
|
{
|
|
5945
6115
|
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
6116
|
inputSchema: {
|
|
5947
|
-
id:
|
|
5948
|
-
cursor:
|
|
6117
|
+
id: z4.string().describe("The epic request to list comments for. Accepts UUID or identifier (e.g., 'ER-1')"),
|
|
6118
|
+
cursor: z4.string().optional().describe(
|
|
5949
6119
|
"Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
|
|
5950
6120
|
),
|
|
5951
|
-
limit:
|
|
6121
|
+
limit: z4.number().int().min(1).max(100).optional().describe(
|
|
5952
6122
|
"Maximum number of comments to return per page (default: 20, max: 100)"
|
|
5953
6123
|
)
|
|
5954
6124
|
}
|
|
@@ -5979,11 +6149,11 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
5979
6149
|
{
|
|
5980
6150
|
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
6151
|
inputSchema: {
|
|
5982
|
-
id:
|
|
5983
|
-
direction:
|
|
6152
|
+
id: z4.string().describe("The epic request to transfer. Accepts UUID or identifier (e.g., 'ER-1')"),
|
|
6153
|
+
direction: z4.enum(["personal-to-team", "team-to-personal"]).describe(
|
|
5984
6154
|
"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
6155
|
),
|
|
5986
|
-
teamId:
|
|
6156
|
+
teamId: z4.string().uuid().optional().describe(
|
|
5987
6157
|
"Target team ID. Required when direction is 'personal-to-team'. Use compbox__list_teams to find available teams."
|
|
5988
6158
|
)
|
|
5989
6159
|
}
|
|
@@ -6037,11 +6207,11 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
6037
6207
|
{
|
|
6038
6208
|
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
6209
|
inputSchema: {
|
|
6040
|
-
id:
|
|
6041
|
-
direction:
|
|
6210
|
+
id: z4.string().describe("The epic to transfer. Accepts UUID or identifier (e.g., 'ENG-E1')"),
|
|
6211
|
+
direction: z4.enum(["personal-to-team", "team-to-personal"]).describe(
|
|
6042
6212
|
"Transfer direction: 'personal-to-team' moves to team scope (requires teamId, cascades to children), 'team-to-personal' moves to your personal scope"
|
|
6043
6213
|
),
|
|
6044
|
-
teamId:
|
|
6214
|
+
teamId: z4.string().uuid().optional().describe(
|
|
6045
6215
|
"Target team ID. Required when direction is 'personal-to-team'. Use compbox__list_teams to find available teams."
|
|
6046
6216
|
)
|
|
6047
6217
|
}
|
|
@@ -6088,29 +6258,29 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
6088
6258
|
{
|
|
6089
6259
|
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
6260
|
inputSchema: {
|
|
6091
|
-
epicRequestId:
|
|
6261
|
+
epicRequestId: z4.string().min(1).describe(
|
|
6092
6262
|
"The epic request ID or identifier (e.g., 'ER-112' or UUID). Required."
|
|
6093
6263
|
),
|
|
6094
|
-
stage:
|
|
6095
|
-
status:
|
|
6264
|
+
stage: z4.enum(["ANALYZE", "DECOMPOSE", "DETAIL", "EVALUATE", "VERIFY"]).describe("The pipeline stage being updated"),
|
|
6265
|
+
status: z4.enum(["active", "completed", "failed"]).describe(
|
|
6096
6266
|
"The new status: active (starting), completed (finished), failed (error)"
|
|
6097
6267
|
),
|
|
6098
|
-
details:
|
|
6268
|
+
details: z4.string().max(2e3).optional().describe(
|
|
6099
6269
|
"Optional context for this stage (e.g., scope summary after ANALYZE)"
|
|
6100
6270
|
),
|
|
6101
|
-
epicId:
|
|
6102
|
-
epicIdentifier:
|
|
6271
|
+
epicId: z4.string().uuid().optional().describe("Created epic UUID \u2014 provide when DECOMPOSE completes"),
|
|
6272
|
+
epicIdentifier: z4.string().optional().describe(
|
|
6103
6273
|
"Created epic identifier (e.g., ENG-E1) \u2014 provide when DECOMPOSE completes"
|
|
6104
6274
|
),
|
|
6105
|
-
qualityScore:
|
|
6106
|
-
overall:
|
|
6107
|
-
epicDescription:
|
|
6108
|
-
structure:
|
|
6109
|
-
detail:
|
|
6110
|
-
scoping:
|
|
6275
|
+
qualityScore: z4.object({
|
|
6276
|
+
overall: z4.number().min(0).max(100).describe("Overall quality score (0\u2013100) summarizing evaluation results"),
|
|
6277
|
+
epicDescription: z4.number().min(0).max(100).describe("Quality of the epic description content and clarity (0\u2013100)"),
|
|
6278
|
+
structure: z4.number().min(0).max(100).describe("Structure and organization quality of the planned epic (0\u2013100)"),
|
|
6279
|
+
detail: z4.number().min(0).max(100).describe("Level of implementation detail and specificity (0\u2013100)"),
|
|
6280
|
+
scoping: z4.number().min(0).max(100).describe("Quality of scoping and boundaries for the epic (0\u2013100)")
|
|
6111
6281
|
}).optional().describe("Quality scores \u2014 provide when EVALUATE completes"),
|
|
6112
|
-
error:
|
|
6113
|
-
message:
|
|
6282
|
+
error: z4.object({
|
|
6283
|
+
message: z4.string().max(1e3).describe("Human-readable error message explaining why the stage failed")
|
|
6114
6284
|
}).optional().describe("Error details when stage fails")
|
|
6115
6285
|
}
|
|
6116
6286
|
},
|
|
@@ -6141,7 +6311,7 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
|
|
|
6141
6311
|
}
|
|
6142
6312
|
|
|
6143
6313
|
// src/tools/features.ts
|
|
6144
|
-
import { z as
|
|
6314
|
+
import { z as z5 } from "zod";
|
|
6145
6315
|
|
|
6146
6316
|
// src/tools/utils/reminder-injector.ts
|
|
6147
6317
|
var REMINDER_RULES = {
|
|
@@ -6211,22 +6381,22 @@ function registerFeatureTools(server2) {
|
|
|
6211
6381
|
{
|
|
6212
6382
|
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
6383
|
inputSchema: {
|
|
6214
|
-
epic:
|
|
6384
|
+
epic: z5.string().optional().describe(
|
|
6215
6385
|
"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
6386
|
),
|
|
6217
|
-
status:
|
|
6387
|
+
status: z5.string().optional().describe(
|
|
6218
6388
|
"Filter by status. Accepts status ID (UUID) or exact status name (e.g., 'In Progress', 'Done'). Status names are team-specific."
|
|
6219
6389
|
),
|
|
6220
|
-
assignee:
|
|
6390
|
+
assignee: z5.string().optional().describe(
|
|
6221
6391
|
"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
6392
|
),
|
|
6223
|
-
query:
|
|
6393
|
+
query: z5.string().optional().describe(
|
|
6224
6394
|
"Search query to filter features by title (case-insensitive substring match). For example, 'login' will match 'User Login Flow' and 'Login Page Redesign'."
|
|
6225
6395
|
),
|
|
6226
|
-
limit:
|
|
6396
|
+
limit: z5.number().int().min(1).max(100).optional().describe(
|
|
6227
6397
|
"Maximum number of features to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
|
|
6228
6398
|
),
|
|
6229
|
-
cursor:
|
|
6399
|
+
cursor: z5.string().optional().describe(
|
|
6230
6400
|
"Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
|
|
6231
6401
|
)
|
|
6232
6402
|
}
|
|
@@ -6256,7 +6426,7 @@ function registerFeatureTools(server2) {
|
|
|
6256
6426
|
{
|
|
6257
6427
|
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
6428
|
inputSchema: {
|
|
6259
|
-
id:
|
|
6429
|
+
id: z5.string().describe(
|
|
6260
6430
|
"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
6431
|
)
|
|
6262
6432
|
}
|
|
@@ -6286,35 +6456,35 @@ function registerFeatureTools(server2) {
|
|
|
6286
6456
|
{
|
|
6287
6457
|
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
6458
|
inputSchema: {
|
|
6289
|
-
title:
|
|
6459
|
+
title: z5.string().min(1).describe(
|
|
6290
6460
|
"The title of the feature (required). Should be a concise description of the work (e.g., 'User Authentication Flow', 'Add Dark Mode Support')."
|
|
6291
6461
|
),
|
|
6292
|
-
epic:
|
|
6462
|
+
epic: z5.string().describe(
|
|
6293
6463
|
"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
6464
|
),
|
|
6295
|
-
description:
|
|
6465
|
+
description: z5.string().optional().describe(
|
|
6296
6466
|
"A detailed description of the feature in Markdown format. Can include requirements, acceptance criteria, technical notes, etc. Supports full Markdown syntax."
|
|
6297
6467
|
),
|
|
6298
|
-
status:
|
|
6468
|
+
status: z5.string().optional().describe(
|
|
6299
6469
|
"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
6470
|
),
|
|
6301
|
-
assignee:
|
|
6471
|
+
assignee: z5.string().optional().describe(
|
|
6302
6472
|
"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
6473
|
),
|
|
6304
6474
|
// Execution metadata
|
|
6305
|
-
executionOrder:
|
|
6475
|
+
executionOrder: z5.number().int().positive().optional().describe(
|
|
6306
6476
|
"Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
|
|
6307
6477
|
),
|
|
6308
|
-
canParallelize:
|
|
6478
|
+
canParallelize: z5.boolean().optional().describe(
|
|
6309
6479
|
"Whether this feature can run alongside other features in parallel."
|
|
6310
6480
|
),
|
|
6311
|
-
parallelGroup:
|
|
6481
|
+
parallelGroup: z5.string().max(100).optional().describe(
|
|
6312
6482
|
"Group identifier for features that can run together in parallel."
|
|
6313
6483
|
),
|
|
6314
|
-
dependencies:
|
|
6484
|
+
dependencies: z5.array(z5.string().uuid()).optional().describe(
|
|
6315
6485
|
"Array of feature UUIDs that must be completed before this feature."
|
|
6316
6486
|
),
|
|
6317
|
-
estimatedComplexity:
|
|
6487
|
+
estimatedComplexity: z5.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
|
|
6318
6488
|
"Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
|
|
6319
6489
|
)
|
|
6320
6490
|
}
|
|
@@ -6371,35 +6541,35 @@ function registerFeatureTools(server2) {
|
|
|
6371
6541
|
{
|
|
6372
6542
|
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
6543
|
inputSchema: {
|
|
6374
|
-
id:
|
|
6544
|
+
id: z5.string().describe(
|
|
6375
6545
|
"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
6546
|
),
|
|
6377
|
-
title:
|
|
6547
|
+
title: z5.string().min(1).optional().describe(
|
|
6378
6548
|
"New title for the feature. Only provide if you want to change the title (e.g., 'Updated: User Authentication Flow')."
|
|
6379
6549
|
),
|
|
6380
|
-
description:
|
|
6550
|
+
description: z5.string().optional().describe(
|
|
6381
6551
|
"New description in Markdown format. Replaces the entire description; there is no append mode. Supports full Markdown syntax."
|
|
6382
6552
|
),
|
|
6383
|
-
status:
|
|
6553
|
+
status: z5.string().optional().describe(
|
|
6384
6554
|
"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
6555
|
),
|
|
6386
|
-
assignee:
|
|
6556
|
+
assignee: z5.string().optional().describe(
|
|
6387
6557
|
"New assignee for the feature. Accepts user ID (UUID) or the special value 'me' to assign to the current authenticated user."
|
|
6388
6558
|
),
|
|
6389
6559
|
// Execution metadata
|
|
6390
|
-
executionOrder:
|
|
6560
|
+
executionOrder: z5.number().int().positive().optional().describe(
|
|
6391
6561
|
"Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
|
|
6392
6562
|
),
|
|
6393
|
-
canParallelize:
|
|
6563
|
+
canParallelize: z5.boolean().optional().describe(
|
|
6394
6564
|
"Whether this feature can run alongside other features in parallel."
|
|
6395
6565
|
),
|
|
6396
|
-
parallelGroup:
|
|
6566
|
+
parallelGroup: z5.string().max(100).optional().describe(
|
|
6397
6567
|
"Group identifier for features that can run together in parallel."
|
|
6398
6568
|
),
|
|
6399
|
-
dependencies:
|
|
6569
|
+
dependencies: z5.array(z5.string().uuid()).optional().describe(
|
|
6400
6570
|
"Array of feature UUIDs that must be completed before this feature."
|
|
6401
6571
|
),
|
|
6402
|
-
estimatedComplexity:
|
|
6572
|
+
estimatedComplexity: z5.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
|
|
6403
6573
|
"Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
|
|
6404
6574
|
)
|
|
6405
6575
|
}
|
|
@@ -6436,26 +6606,26 @@ function registerFeatureTools(server2) {
|
|
|
6436
6606
|
}
|
|
6437
6607
|
|
|
6438
6608
|
// src/tools/tasks.ts
|
|
6439
|
-
import { z as
|
|
6609
|
+
import { z as z6 } from "zod";
|
|
6440
6610
|
function registerTaskTools(server2) {
|
|
6441
6611
|
server2.registerTool(
|
|
6442
6612
|
"compbox__list_tasks",
|
|
6443
6613
|
{
|
|
6444
6614
|
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
6615
|
inputSchema: {
|
|
6446
|
-
feature:
|
|
6616
|
+
feature: z6.string().optional().describe(
|
|
6447
6617
|
"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
6618
|
),
|
|
6449
|
-
status:
|
|
6619
|
+
status: z6.string().optional().describe(
|
|
6450
6620
|
"Filter by status ID (UUID). Tasks use the same status system as features, scoped to the feature's team."
|
|
6451
6621
|
),
|
|
6452
|
-
assignee:
|
|
6622
|
+
assignee: z6.string().optional().describe(
|
|
6453
6623
|
"Filter by assignee user ID (UUID). Returns only tasks assigned to the specified user."
|
|
6454
6624
|
),
|
|
6455
|
-
limit:
|
|
6625
|
+
limit: z6.number().int().min(1).max(100).optional().describe(
|
|
6456
6626
|
"Maximum number of tasks to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
|
|
6457
6627
|
),
|
|
6458
|
-
cursor:
|
|
6628
|
+
cursor: z6.string().optional().describe(
|
|
6459
6629
|
"Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
|
|
6460
6630
|
)
|
|
6461
6631
|
}
|
|
@@ -6487,7 +6657,7 @@ function registerTaskTools(server2) {
|
|
|
6487
6657
|
{
|
|
6488
6658
|
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
6659
|
inputSchema: {
|
|
6490
|
-
id:
|
|
6660
|
+
id: z6.string().describe(
|
|
6491
6661
|
"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
6662
|
)
|
|
6493
6663
|
}
|
|
@@ -6510,35 +6680,35 @@ function registerTaskTools(server2) {
|
|
|
6510
6680
|
{
|
|
6511
6681
|
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
6682
|
inputSchema: {
|
|
6513
|
-
title:
|
|
6683
|
+
title: z6.string().min(1).describe(
|
|
6514
6684
|
"The title of the task (required). Should be a concise, actionable description (e.g., 'Implement password validation', 'Write unit tests for auth module')."
|
|
6515
6685
|
),
|
|
6516
|
-
feature_id:
|
|
6686
|
+
feature_id: z6.string().describe(
|
|
6517
6687
|
"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
6688
|
),
|
|
6519
|
-
description:
|
|
6689
|
+
description: z6.string().optional().describe(
|
|
6520
6690
|
"A detailed description of the task in Markdown format. Can include implementation notes, acceptance criteria, or technical details. Supports full Markdown syntax."
|
|
6521
6691
|
),
|
|
6522
|
-
status:
|
|
6692
|
+
status: z6.string().optional().describe(
|
|
6523
6693
|
"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
6694
|
),
|
|
6525
|
-
assignee:
|
|
6695
|
+
assignee: z6.string().optional().describe(
|
|
6526
6696
|
"User ID (UUID) to assign this task to. If not provided, the task is unassigned."
|
|
6527
6697
|
),
|
|
6528
6698
|
// Execution metadata
|
|
6529
|
-
executionOrder:
|
|
6699
|
+
executionOrder: z6.number().int().positive().optional().describe(
|
|
6530
6700
|
"Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
|
|
6531
6701
|
),
|
|
6532
|
-
canParallelize:
|
|
6702
|
+
canParallelize: z6.boolean().optional().describe(
|
|
6533
6703
|
"Whether this task can run alongside other tasks in parallel."
|
|
6534
6704
|
),
|
|
6535
|
-
parallelGroup:
|
|
6705
|
+
parallelGroup: z6.string().max(100).optional().describe(
|
|
6536
6706
|
"Group identifier for tasks that can run together in parallel."
|
|
6537
6707
|
),
|
|
6538
|
-
dependencies:
|
|
6708
|
+
dependencies: z6.array(z6.string().uuid()).optional().describe(
|
|
6539
6709
|
"Array of task UUIDs that must be completed before this task."
|
|
6540
6710
|
),
|
|
6541
|
-
estimatedComplexity:
|
|
6711
|
+
estimatedComplexity: z6.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
|
|
6542
6712
|
"Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
|
|
6543
6713
|
)
|
|
6544
6714
|
}
|
|
@@ -6596,35 +6766,35 @@ function registerTaskTools(server2) {
|
|
|
6596
6766
|
{
|
|
6597
6767
|
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
6768
|
inputSchema: {
|
|
6599
|
-
id:
|
|
6769
|
+
id: z6.string().describe(
|
|
6600
6770
|
"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
6771
|
),
|
|
6602
|
-
title:
|
|
6772
|
+
title: z6.string().min(1).optional().describe(
|
|
6603
6773
|
"New title for the task. Only provide if you want to change the title (e.g., 'Updated: Implement password validation')."
|
|
6604
6774
|
),
|
|
6605
|
-
description:
|
|
6775
|
+
description: z6.string().optional().describe(
|
|
6606
6776
|
"New description in Markdown format. Replaces the entire description; there is no append mode. Supports full Markdown syntax."
|
|
6607
6777
|
),
|
|
6608
|
-
status:
|
|
6778
|
+
status: z6.string().optional().describe(
|
|
6609
6779
|
"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
6780
|
),
|
|
6611
|
-
assignee:
|
|
6781
|
+
assignee: z6.string().optional().describe(
|
|
6612
6782
|
"New assignee user ID (UUID) for the task."
|
|
6613
6783
|
),
|
|
6614
6784
|
// Execution metadata
|
|
6615
|
-
executionOrder:
|
|
6785
|
+
executionOrder: z6.number().int().positive().optional().describe(
|
|
6616
6786
|
"Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
|
|
6617
6787
|
),
|
|
6618
|
-
canParallelize:
|
|
6788
|
+
canParallelize: z6.boolean().optional().describe(
|
|
6619
6789
|
"Whether this task can run alongside other tasks in parallel."
|
|
6620
6790
|
),
|
|
6621
|
-
parallelGroup:
|
|
6791
|
+
parallelGroup: z6.string().max(100).optional().describe(
|
|
6622
6792
|
"Group identifier for tasks that can run together in parallel."
|
|
6623
6793
|
),
|
|
6624
|
-
dependencies:
|
|
6794
|
+
dependencies: z6.array(z6.string().uuid()).optional().describe(
|
|
6625
6795
|
"Array of task UUIDs that must be completed before this task."
|
|
6626
6796
|
),
|
|
6627
|
-
estimatedComplexity:
|
|
6797
|
+
estimatedComplexity: z6.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
|
|
6628
6798
|
"Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
|
|
6629
6799
|
)
|
|
6630
6800
|
}
|
|
@@ -6662,17 +6832,17 @@ function registerTaskTools(server2) {
|
|
|
6662
6832
|
}
|
|
6663
6833
|
|
|
6664
6834
|
// src/tools/statuses.ts
|
|
6665
|
-
import { z as
|
|
6835
|
+
import { z as z7 } from "zod";
|
|
6666
6836
|
var listStatusesSchema = {
|
|
6667
|
-
team:
|
|
6837
|
+
team: z7.string().describe(
|
|
6668
6838
|
"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
6839
|
)
|
|
6670
6840
|
};
|
|
6671
6841
|
var getStatusSchema = {
|
|
6672
|
-
id:
|
|
6842
|
+
id: z7.string().describe(
|
|
6673
6843
|
"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
6844
|
),
|
|
6675
|
-
team:
|
|
6845
|
+
team: z7.string().optional().describe(
|
|
6676
6846
|
"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
6847
|
)
|
|
6678
6848
|
};
|
|
@@ -6742,30 +6912,30 @@ function registerStatusTools(server2) {
|
|
|
6742
6912
|
}
|
|
6743
6913
|
|
|
6744
6914
|
// src/tools/ordering.ts
|
|
6745
|
-
import { z as
|
|
6915
|
+
import { z as z8 } from "zod";
|
|
6746
6916
|
function registerOrderingTools(server2) {
|
|
6747
6917
|
server2.registerTool(
|
|
6748
6918
|
"compbox__reorder_item",
|
|
6749
6919
|
{
|
|
6750
6920
|
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:
|
|
6921
|
+
inputSchema: z8.discriminatedUnion("action", [
|
|
6922
|
+
z8.object({
|
|
6923
|
+
action: z8.literal("reorder_epic"),
|
|
6924
|
+
id: z8.string().uuid().describe("UUID of the epic to reorder"),
|
|
6925
|
+
afterId: z8.string().uuid().optional().describe("UUID of the epic to place this after"),
|
|
6926
|
+
beforeId: z8.string().uuid().optional().describe("UUID of the epic to place this before")
|
|
6757
6927
|
}),
|
|
6758
|
-
|
|
6759
|
-
action:
|
|
6760
|
-
id:
|
|
6761
|
-
afterId:
|
|
6762
|
-
beforeId:
|
|
6928
|
+
z8.object({
|
|
6929
|
+
action: z8.literal("reorder_feature"),
|
|
6930
|
+
id: z8.string().uuid().describe("UUID of the feature to reorder"),
|
|
6931
|
+
afterId: z8.string().uuid().optional().describe("UUID of the feature to place this after"),
|
|
6932
|
+
beforeId: z8.string().uuid().optional().describe("UUID of the feature to place this before")
|
|
6763
6933
|
}),
|
|
6764
|
-
|
|
6765
|
-
action:
|
|
6766
|
-
id:
|
|
6767
|
-
afterId:
|
|
6768
|
-
beforeId:
|
|
6934
|
+
z8.object({
|
|
6935
|
+
action: z8.literal("reorder_task"),
|
|
6936
|
+
id: z8.string().uuid().describe("UUID of the task to reorder"),
|
|
6937
|
+
afterId: z8.string().uuid().optional().describe("UUID of the task to place this after"),
|
|
6938
|
+
beforeId: z8.string().uuid().optional().describe("UUID of the task to place this before")
|
|
6769
6939
|
})
|
|
6770
6940
|
])
|
|
6771
6941
|
},
|
|
@@ -6835,13 +7005,13 @@ function registerOrderingTools(server2) {
|
|
|
6835
7005
|
{
|
|
6836
7006
|
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
7007
|
inputSchema: {
|
|
6838
|
-
id:
|
|
7008
|
+
id: z8.string().uuid().describe(
|
|
6839
7009
|
"The UUID of the epic to reorder."
|
|
6840
7010
|
),
|
|
6841
|
-
afterId:
|
|
7011
|
+
afterId: z8.string().uuid().optional().describe(
|
|
6842
7012
|
"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
7013
|
),
|
|
6844
|
-
beforeId:
|
|
7014
|
+
beforeId: z8.string().uuid().optional().describe(
|
|
6845
7015
|
"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
7016
|
)
|
|
6847
7017
|
}
|
|
@@ -6882,13 +7052,13 @@ function registerOrderingTools(server2) {
|
|
|
6882
7052
|
{
|
|
6883
7053
|
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
7054
|
inputSchema: {
|
|
6885
|
-
id:
|
|
7055
|
+
id: z8.string().uuid().describe(
|
|
6886
7056
|
"The UUID of the feature to reorder."
|
|
6887
7057
|
),
|
|
6888
|
-
afterId:
|
|
7058
|
+
afterId: z8.string().uuid().optional().describe(
|
|
6889
7059
|
"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
7060
|
),
|
|
6891
|
-
beforeId:
|
|
7061
|
+
beforeId: z8.string().uuid().optional().describe(
|
|
6892
7062
|
"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
7063
|
)
|
|
6894
7064
|
}
|
|
@@ -6929,13 +7099,13 @@ function registerOrderingTools(server2) {
|
|
|
6929
7099
|
{
|
|
6930
7100
|
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
7101
|
inputSchema: {
|
|
6932
|
-
id:
|
|
7102
|
+
id: z8.string().uuid().describe(
|
|
6933
7103
|
"The UUID of the task to reorder."
|
|
6934
7104
|
),
|
|
6935
|
-
afterId:
|
|
7105
|
+
afterId: z8.string().uuid().optional().describe(
|
|
6936
7106
|
"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
7107
|
),
|
|
6938
|
-
beforeId:
|
|
7108
|
+
beforeId: z8.string().uuid().optional().describe(
|
|
6939
7109
|
"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
7110
|
)
|
|
6941
7111
|
}
|
|
@@ -6974,41 +7144,41 @@ function registerOrderingTools(server2) {
|
|
|
6974
7144
|
}
|
|
6975
7145
|
|
|
6976
7146
|
// src/tools/search.ts
|
|
6977
|
-
import { z as
|
|
7147
|
+
import { z as z9 } from "zod";
|
|
6978
7148
|
function registerSearchTools(server2) {
|
|
6979
7149
|
server2.registerTool(
|
|
6980
7150
|
"compbox__search",
|
|
6981
7151
|
{
|
|
6982
7152
|
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
7153
|
inputSchema: {
|
|
6984
|
-
query:
|
|
7154
|
+
query: z9.string().optional().describe(
|
|
6985
7155
|
"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
7156
|
),
|
|
6987
|
-
epic:
|
|
7157
|
+
epic: z9.string().optional().describe(
|
|
6988
7158
|
"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
7159
|
),
|
|
6990
|
-
status:
|
|
7160
|
+
status: z9.string().optional().describe(
|
|
6991
7161
|
"Filter by status. Accepts status ID (UUID) or exact status name (e.g., 'In Progress', 'Done'). Status names are team-specific."
|
|
6992
7162
|
),
|
|
6993
|
-
statusCategory:
|
|
7163
|
+
statusCategory: z9.string().optional().describe(
|
|
6994
7164
|
"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
7165
|
),
|
|
6996
|
-
assignee:
|
|
7166
|
+
assignee: z9.string().optional().describe(
|
|
6997
7167
|
"Filter by assignee. Accepts user ID (UUID), email address, or special values: 'me' for the current authenticated user, 'none' for unassigned items."
|
|
6998
7168
|
),
|
|
6999
|
-
createdAt:
|
|
7169
|
+
createdAt: z9.string().optional().describe(
|
|
7000
7170
|
"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
7171
|
),
|
|
7002
|
-
updatedAt:
|
|
7172
|
+
updatedAt: z9.string().optional().describe(
|
|
7003
7173
|
"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
7174
|
),
|
|
7005
|
-
type:
|
|
7175
|
+
type: z9.enum(["feature", "task", "all"]).optional().describe(
|
|
7006
7176
|
"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
7177
|
),
|
|
7008
|
-
limit:
|
|
7178
|
+
limit: z9.number().int().min(1).max(100).optional().describe(
|
|
7009
7179
|
"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
7180
|
),
|
|
7011
|
-
cursor:
|
|
7181
|
+
cursor: z9.string().optional().describe(
|
|
7012
7182
|
"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
7183
|
)
|
|
7014
7184
|
}
|
|
@@ -7043,7 +7213,7 @@ function registerSearchTools(server2) {
|
|
|
7043
7213
|
}
|
|
7044
7214
|
|
|
7045
7215
|
// src/tools/personal.ts
|
|
7046
|
-
import { z as
|
|
7216
|
+
import { z as z10 } from "zod";
|
|
7047
7217
|
function registerPersonalTools(server2) {
|
|
7048
7218
|
server2.registerTool(
|
|
7049
7219
|
"compbox__get_personal_scope",
|
|
@@ -7074,10 +7244,10 @@ function registerPersonalTools(server2) {
|
|
|
7074
7244
|
{
|
|
7075
7245
|
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
7246
|
inputSchema: {
|
|
7077
|
-
limit:
|
|
7247
|
+
limit: z10.number().int().min(1).max(100).optional().describe(
|
|
7078
7248
|
"Maximum number of projects to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
|
|
7079
7249
|
),
|
|
7080
|
-
cursor:
|
|
7250
|
+
cursor: z10.string().optional().describe(
|
|
7081
7251
|
"Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
|
|
7082
7252
|
)
|
|
7083
7253
|
}
|
|
@@ -7121,16 +7291,16 @@ function registerPersonalTools(server2) {
|
|
|
7121
7291
|
{
|
|
7122
7292
|
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
7293
|
inputSchema: {
|
|
7124
|
-
name:
|
|
7294
|
+
name: z10.string().min(1).describe(
|
|
7125
7295
|
"The display name for the project (required). Should be descriptive (e.g., 'Personal Tasks', 'Side Project Ideas', 'Learning Goals')."
|
|
7126
7296
|
),
|
|
7127
|
-
description:
|
|
7297
|
+
description: z10.string().optional().describe(
|
|
7128
7298
|
"A longer description of the project's purpose and scope. Supports plain text (e.g., 'My personal task tracking and notes')."
|
|
7129
7299
|
),
|
|
7130
|
-
icon:
|
|
7300
|
+
icon: z10.string().optional().describe(
|
|
7131
7301
|
"An icon identifier for visual display (e.g., 'rocket', 'star', 'folder'). Used in the UI to help identify the project at a glance."
|
|
7132
7302
|
),
|
|
7133
|
-
color:
|
|
7303
|
+
color: z10.string().optional().describe(
|
|
7134
7304
|
"A hex color code for the project's visual theme (e.g., '#FF5733', '#3B82F6'). Used in the UI for project badges and highlights."
|
|
7135
7305
|
)
|
|
7136
7306
|
}
|
|
@@ -7201,13 +7371,13 @@ function registerPersonalTools(server2) {
|
|
|
7201
7371
|
{
|
|
7202
7372
|
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
7373
|
inputSchema: {
|
|
7204
|
-
cursor:
|
|
7374
|
+
cursor: z10.string().optional().describe(
|
|
7205
7375
|
"Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
|
|
7206
7376
|
),
|
|
7207
|
-
limit:
|
|
7377
|
+
limit: z10.number().int().min(1).max(100).optional().describe(
|
|
7208
7378
|
"Maximum number of epic requests to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
|
|
7209
7379
|
),
|
|
7210
|
-
status:
|
|
7380
|
+
status: z10.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
|
|
7211
7381
|
"Filter by request status: 'pending', 'approved', 'rejected', or 'converted'. Personal requests require approval like team requests."
|
|
7212
7382
|
)
|
|
7213
7383
|
}
|
|
@@ -7236,7 +7406,7 @@ function registerPersonalTools(server2) {
|
|
|
7236
7406
|
}
|
|
7237
7407
|
|
|
7238
7408
|
// src/tools/execution.ts
|
|
7239
|
-
import { z as
|
|
7409
|
+
import { z as z11 } from "zod";
|
|
7240
7410
|
var complexityValues = ["trivial", "simple", "moderate", "complex"];
|
|
7241
7411
|
function registerExecutionTools(server2) {
|
|
7242
7412
|
server2.registerTool(
|
|
@@ -7244,7 +7414,7 @@ function registerExecutionTools(server2) {
|
|
|
7244
7414
|
{
|
|
7245
7415
|
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
7416
|
inputSchema: {
|
|
7247
|
-
epicId:
|
|
7417
|
+
epicId: z11.string().describe(
|
|
7248
7418
|
"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
7419
|
)
|
|
7250
7420
|
}
|
|
@@ -7268,23 +7438,23 @@ function registerExecutionTools(server2) {
|
|
|
7268
7438
|
{
|
|
7269
7439
|
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
7440
|
inputSchema: {
|
|
7271
|
-
id:
|
|
7441
|
+
id: z11.string().describe(
|
|
7272
7442
|
"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
7443
|
),
|
|
7274
|
-
type:
|
|
7275
|
-
executionOrder:
|
|
7444
|
+
type: z11.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
|
|
7445
|
+
executionOrder: z11.number().int().positive().optional().describe(
|
|
7276
7446
|
"Suggested execution order (1, 2, 3...). Items with lower numbers should be worked on first. Items without executionOrder are processed after numbered items."
|
|
7277
7447
|
),
|
|
7278
|
-
canParallelize:
|
|
7448
|
+
canParallelize: z11.boolean().optional().describe(
|
|
7279
7449
|
"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
7450
|
),
|
|
7281
|
-
parallelGroup:
|
|
7451
|
+
parallelGroup: z11.string().max(100).optional().describe(
|
|
7282
7452
|
"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
7453
|
),
|
|
7284
|
-
dependencies:
|
|
7454
|
+
dependencies: z11.array(z11.string().uuid()).optional().describe(
|
|
7285
7455
|
"Array of feature/task UUIDs that must be completed before this item. The execution plan will ensure dependencies are scheduled in earlier phases."
|
|
7286
7456
|
),
|
|
7287
|
-
estimatedComplexity:
|
|
7457
|
+
estimatedComplexity: z11.enum(complexityValues).optional().describe(
|
|
7288
7458
|
"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
7459
|
)
|
|
7290
7460
|
}
|
|
@@ -7351,11 +7521,11 @@ ${JSON.stringify(result, null, 2)}`
|
|
|
7351
7521
|
{
|
|
7352
7522
|
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
7523
|
inputSchema: {
|
|
7354
|
-
id:
|
|
7524
|
+
id: z11.string().describe(
|
|
7355
7525
|
"The feature or task that is blocked. Accepts UUID or human-readable identifier."
|
|
7356
7526
|
),
|
|
7357
|
-
type:
|
|
7358
|
-
blockedById:
|
|
7527
|
+
type: z11.enum(["feature", "task"]).describe("Whether the blocked item is a 'feature' or 'task'."),
|
|
7528
|
+
blockedById: z11.string().uuid().describe(
|
|
7359
7529
|
"The UUID of the feature or task that is blocking this item. This item will be added to the dependencies list."
|
|
7360
7530
|
)
|
|
7361
7531
|
}
|
|
@@ -7404,11 +7574,11 @@ ${JSON.stringify(result, null, 2)}`
|
|
|
7404
7574
|
{
|
|
7405
7575
|
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
7576
|
inputSchema: {
|
|
7407
|
-
id:
|
|
7577
|
+
id: z11.string().describe(
|
|
7408
7578
|
"The feature or task to unblock. Accepts UUID or human-readable identifier."
|
|
7409
7579
|
),
|
|
7410
|
-
type:
|
|
7411
|
-
unblockedFromId:
|
|
7580
|
+
type: z11.enum(["feature", "task"]).describe("Whether the item is a 'feature' or 'task'."),
|
|
7581
|
+
unblockedFromId: z11.string().uuid().describe(
|
|
7412
7582
|
"The UUID of the feature or task to remove from dependencies."
|
|
7413
7583
|
)
|
|
7414
7584
|
}
|
|
@@ -7453,7 +7623,7 @@ ${JSON.stringify(result, null, 2)}`
|
|
|
7453
7623
|
}
|
|
7454
7624
|
|
|
7455
7625
|
// src/tools/help.ts
|
|
7456
|
-
import { z as
|
|
7626
|
+
import { z as z12 } from "zod";
|
|
7457
7627
|
var topicValues = ["all", "overview", "execution", "progress", "summary", "search", "workflow", "personal", "templates", "sessions", "structured", "codeContext", "validations", "decisions"];
|
|
7458
7628
|
var helpTopics = {
|
|
7459
7629
|
overview: `# CompBox Overview
|
|
@@ -8528,7 +8698,7 @@ function registerHelpTools(server2) {
|
|
|
8528
8698
|
{
|
|
8529
8699
|
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
8700
|
inputSchema: {
|
|
8531
|
-
topic:
|
|
8701
|
+
topic: z12.enum(topicValues).default("all").describe(
|
|
8532
8702
|
"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
8703
|
)
|
|
8534
8704
|
}
|
|
@@ -8545,32 +8715,32 @@ function registerHelpTools(server2) {
|
|
|
8545
8715
|
}
|
|
8546
8716
|
|
|
8547
8717
|
// src/tools/ai-context.ts
|
|
8548
|
-
import { z as
|
|
8718
|
+
import { z as z13 } from "zod";
|
|
8549
8719
|
function registerAiContextTools(server2) {
|
|
8550
8720
|
server2.registerTool(
|
|
8551
8721
|
"compbox__manage_ai_context",
|
|
8552
8722
|
{
|
|
8553
8723
|
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:
|
|
8724
|
+
inputSchema: z13.discriminatedUnion("action", [
|
|
8725
|
+
z13.object({
|
|
8726
|
+
action: z13.literal("get_context"),
|
|
8727
|
+
id: z13.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
|
|
8728
|
+
type: z13.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'")
|
|
8559
8729
|
}),
|
|
8560
|
-
|
|
8561
|
-
action:
|
|
8562
|
-
id:
|
|
8563
|
-
type:
|
|
8564
|
-
context:
|
|
8565
|
-
sessionId:
|
|
8730
|
+
z13.object({
|
|
8731
|
+
action: z13.literal("set_context"),
|
|
8732
|
+
id: z13.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
|
|
8733
|
+
type: z13.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'"),
|
|
8734
|
+
context: z13.string().max(5e4).describe("Structured context for AI consumption (replaces entire field)"),
|
|
8735
|
+
sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
|
|
8566
8736
|
}),
|
|
8567
|
-
|
|
8568
|
-
action:
|
|
8569
|
-
id:
|
|
8570
|
-
type:
|
|
8571
|
-
noteType:
|
|
8572
|
-
content:
|
|
8573
|
-
sessionId:
|
|
8737
|
+
z13.object({
|
|
8738
|
+
action: z13.literal("append_note"),
|
|
8739
|
+
id: z13.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
|
|
8740
|
+
type: z13.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'"),
|
|
8741
|
+
noteType: z13.enum(["observation", "decision", "blocker", "next-step", "context"]).describe("Type of note"),
|
|
8742
|
+
content: z13.string().min(1).max(1e4).describe("Content of the note"),
|
|
8743
|
+
sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
|
|
8574
8744
|
})
|
|
8575
8745
|
])
|
|
8576
8746
|
},
|
|
@@ -8718,10 +8888,10 @@ function registerAiContextTools(server2) {
|
|
|
8718
8888
|
{
|
|
8719
8889
|
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
8890
|
inputSchema: {
|
|
8721
|
-
id:
|
|
8891
|
+
id: z13.string().describe(
|
|
8722
8892
|
"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
8893
|
),
|
|
8724
|
-
type:
|
|
8894
|
+
type: z13.enum(["feature", "task", "epic"]).describe(
|
|
8725
8895
|
"Whether this is a 'feature', 'task', or 'epic'."
|
|
8726
8896
|
)
|
|
8727
8897
|
}
|
|
@@ -8770,16 +8940,16 @@ function registerAiContextTools(server2) {
|
|
|
8770
8940
|
{
|
|
8771
8941
|
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
8942
|
inputSchema: {
|
|
8773
|
-
id:
|
|
8943
|
+
id: z13.string().describe(
|
|
8774
8944
|
"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
8945
|
),
|
|
8776
|
-
type:
|
|
8946
|
+
type: z13.enum(["feature", "task", "epic"]).describe(
|
|
8777
8947
|
"Whether this is a 'feature', 'task', or 'epic'."
|
|
8778
8948
|
),
|
|
8779
|
-
context:
|
|
8949
|
+
context: z13.string().max(5e4).describe(
|
|
8780
8950
|
"Structured context for AI consumption. Can be free-form text, markdown, or structured data. This replaces the entire context field."
|
|
8781
8951
|
),
|
|
8782
|
-
sessionId:
|
|
8952
|
+
sessionId: z13.string().max(255).optional().describe(
|
|
8783
8953
|
"Optional identifier for this AI session. Helps track which session made changes."
|
|
8784
8954
|
)
|
|
8785
8955
|
}
|
|
@@ -8837,19 +9007,19 @@ function registerAiContextTools(server2) {
|
|
|
8837
9007
|
{
|
|
8838
9008
|
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
9009
|
inputSchema: {
|
|
8840
|
-
id:
|
|
9010
|
+
id: z13.string().describe(
|
|
8841
9011
|
"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
9012
|
),
|
|
8843
|
-
type:
|
|
9013
|
+
type: z13.enum(["feature", "task", "epic"]).describe(
|
|
8844
9014
|
"Whether this is a 'feature', 'task', or 'epic'."
|
|
8845
9015
|
),
|
|
8846
|
-
noteType:
|
|
9016
|
+
noteType: z13.enum(["observation", "decision", "blocker", "next-step", "context"]).describe(
|
|
8847
9017
|
"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
9018
|
),
|
|
8849
|
-
content:
|
|
9019
|
+
content: z13.string().min(1).max(1e4).describe(
|
|
8850
9020
|
"The content of the note. Should be clear and actionable for future AI sessions."
|
|
8851
9021
|
),
|
|
8852
|
-
sessionId:
|
|
9022
|
+
sessionId: z13.string().max(255).optional().describe(
|
|
8853
9023
|
"Optional identifier for this AI session. Helps track which session added the note."
|
|
8854
9024
|
)
|
|
8855
9025
|
}
|
|
@@ -8923,49 +9093,49 @@ function registerAiContextTools(server2) {
|
|
|
8923
9093
|
}
|
|
8924
9094
|
|
|
8925
9095
|
// src/tools/progress.ts
|
|
8926
|
-
import { z as
|
|
9096
|
+
import { z as z14 } from "zod";
|
|
8927
9097
|
function registerProgressTools(server2) {
|
|
8928
9098
|
server2.registerTool(
|
|
8929
9099
|
"compbox__manage_progress",
|
|
8930
9100
|
{
|
|
8931
9101
|
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:
|
|
9102
|
+
inputSchema: z14.discriminatedUnion("action", [
|
|
9103
|
+
z14.object({
|
|
9104
|
+
action: z14.literal("start_work"),
|
|
9105
|
+
id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
9106
|
+
type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
9107
|
+
sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
|
|
8938
9108
|
}),
|
|
8939
|
-
|
|
8940
|
-
action:
|
|
8941
|
-
id:
|
|
8942
|
-
type:
|
|
8943
|
-
summary:
|
|
8944
|
-
sessionId:
|
|
9109
|
+
z14.object({
|
|
9110
|
+
action: z14.literal("complete_work"),
|
|
9111
|
+
id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
9112
|
+
type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
9113
|
+
summary: z14.string().max(5e3).optional().describe("Optional summary of work completed"),
|
|
9114
|
+
sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
|
|
8945
9115
|
}),
|
|
8946
|
-
|
|
8947
|
-
action:
|
|
8948
|
-
id:
|
|
8949
|
-
type:
|
|
8950
|
-
message:
|
|
8951
|
-
percentComplete:
|
|
8952
|
-
sessionId:
|
|
9116
|
+
z14.object({
|
|
9117
|
+
action: z14.literal("log_progress"),
|
|
9118
|
+
id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
9119
|
+
type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
9120
|
+
message: z14.string().min(1).max(5e3).describe("Progress message to log as AI note"),
|
|
9121
|
+
percentComplete: z14.number().int().min(0).max(100).optional().describe("Optional percentage (0-100)"),
|
|
9122
|
+
sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
|
|
8953
9123
|
}),
|
|
8954
|
-
|
|
8955
|
-
action:
|
|
8956
|
-
id:
|
|
8957
|
-
type:
|
|
8958
|
-
reason:
|
|
8959
|
-
blockedById:
|
|
8960
|
-
sessionId:
|
|
9124
|
+
z14.object({
|
|
9125
|
+
action: z14.literal("report_blocker"),
|
|
9126
|
+
id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
9127
|
+
type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
9128
|
+
reason: z14.string().min(1).max(5e3).describe("Description of what is blocking progress"),
|
|
9129
|
+
blockedById: z14.string().uuid().optional().describe("Optional UUID of the blocking item"),
|
|
9130
|
+
sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
|
|
8961
9131
|
}),
|
|
8962
|
-
|
|
8963
|
-
action:
|
|
8964
|
-
id:
|
|
8965
|
-
type:
|
|
8966
|
-
resolution:
|
|
8967
|
-
unblockedFromId:
|
|
8968
|
-
sessionId:
|
|
9132
|
+
z14.object({
|
|
9133
|
+
action: z14.literal("resolve_blocker"),
|
|
9134
|
+
id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
9135
|
+
type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
9136
|
+
resolution: z14.string().min(1).max(5e3).describe("Description of how the blocker was resolved"),
|
|
9137
|
+
unblockedFromId: z14.string().uuid().optional().describe("Optional UUID of the blocking item to drop from this item's dependencies"),
|
|
9138
|
+
sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
|
|
8969
9139
|
})
|
|
8970
9140
|
])
|
|
8971
9141
|
},
|
|
@@ -9076,13 +9246,13 @@ function registerProgressTools(server2) {
|
|
|
9076
9246
|
{
|
|
9077
9247
|
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
9248
|
inputSchema: {
|
|
9079
|
-
id:
|
|
9249
|
+
id: z14.string().describe(
|
|
9080
9250
|
"The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
|
|
9081
9251
|
),
|
|
9082
|
-
type:
|
|
9252
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9083
9253
|
"Whether this is a 'feature' or 'task'."
|
|
9084
9254
|
),
|
|
9085
|
-
sessionId:
|
|
9255
|
+
sessionId: z14.string().max(255).optional().describe(
|
|
9086
9256
|
"Optional identifier for this AI session. Helps track which session started the work."
|
|
9087
9257
|
)
|
|
9088
9258
|
}
|
|
@@ -9116,16 +9286,16 @@ function registerProgressTools(server2) {
|
|
|
9116
9286
|
{
|
|
9117
9287
|
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
9288
|
inputSchema: {
|
|
9119
|
-
id:
|
|
9289
|
+
id: z14.string().describe(
|
|
9120
9290
|
"The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
|
|
9121
9291
|
),
|
|
9122
|
-
type:
|
|
9292
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9123
9293
|
"Whether this is a 'feature' or 'task'."
|
|
9124
9294
|
),
|
|
9125
|
-
summary:
|
|
9295
|
+
summary: z14.string().max(5e3).optional().describe(
|
|
9126
9296
|
"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
9297
|
),
|
|
9128
|
-
sessionId:
|
|
9298
|
+
sessionId: z14.string().max(255).optional().describe(
|
|
9129
9299
|
"Optional identifier for this AI session."
|
|
9130
9300
|
)
|
|
9131
9301
|
}
|
|
@@ -9161,19 +9331,19 @@ function registerProgressTools(server2) {
|
|
|
9161
9331
|
{
|
|
9162
9332
|
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
9333
|
inputSchema: {
|
|
9164
|
-
id:
|
|
9334
|
+
id: z14.string().describe(
|
|
9165
9335
|
"The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
|
|
9166
9336
|
),
|
|
9167
|
-
type:
|
|
9337
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9168
9338
|
"Whether this is a 'feature' or 'task'."
|
|
9169
9339
|
),
|
|
9170
|
-
message:
|
|
9340
|
+
message: z14.string().min(1).max(5e3).describe(
|
|
9171
9341
|
"Progress message describing what has been done or the current state. This will be logged as an AI note."
|
|
9172
9342
|
),
|
|
9173
|
-
percentComplete:
|
|
9343
|
+
percentComplete: z14.number().int().min(0).max(100).optional().describe(
|
|
9174
9344
|
"Optional percentage (0-100) indicating overall completion. Useful for tracking progress on multi-step work items."
|
|
9175
9345
|
),
|
|
9176
|
-
sessionId:
|
|
9346
|
+
sessionId: z14.string().max(255).optional().describe(
|
|
9177
9347
|
"Optional identifier for this AI session."
|
|
9178
9348
|
)
|
|
9179
9349
|
}
|
|
@@ -9211,19 +9381,19 @@ function registerProgressTools(server2) {
|
|
|
9211
9381
|
{
|
|
9212
9382
|
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
9383
|
inputSchema: {
|
|
9214
|
-
id:
|
|
9384
|
+
id: z14.string().describe(
|
|
9215
9385
|
"The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
|
|
9216
9386
|
),
|
|
9217
|
-
type:
|
|
9387
|
+
type: z14.enum(["feature", "task"]).describe(
|
|
9218
9388
|
"Whether this is a 'feature' or 'task'."
|
|
9219
9389
|
),
|
|
9220
|
-
reason:
|
|
9390
|
+
reason: z14.string().min(1).max(5e3).describe(
|
|
9221
9391
|
"Description of what is blocking progress. Be specific about what needs to happen to unblock."
|
|
9222
9392
|
),
|
|
9223
|
-
blockedById:
|
|
9393
|
+
blockedById: z14.string().uuid().optional().describe(
|
|
9224
9394
|
"Optional UUID of the feature or task that is blocking this item. This creates a dependency relationship."
|
|
9225
9395
|
),
|
|
9226
|
-
sessionId:
|
|
9396
|
+
sessionId: z14.string().max(255).optional().describe(
|
|
9227
9397
|
"Optional identifier for this AI session."
|
|
9228
9398
|
)
|
|
9229
9399
|
}
|
|
@@ -9259,7 +9429,7 @@ function registerProgressTools(server2) {
|
|
|
9259
9429
|
}
|
|
9260
9430
|
|
|
9261
9431
|
// src/tools/templates.ts
|
|
9262
|
-
import { z as
|
|
9432
|
+
import { z as z15 } from "zod";
|
|
9263
9433
|
async function resolveTeamId3(teamQuery) {
|
|
9264
9434
|
const apiClient = getApiClient();
|
|
9265
9435
|
const result = await apiClient.getTeam(teamQuery);
|
|
@@ -9295,7 +9465,7 @@ function registerTemplateTools(server2) {
|
|
|
9295
9465
|
{
|
|
9296
9466
|
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
9467
|
inputSchema: {
|
|
9298
|
-
name:
|
|
9468
|
+
name: z15.string().describe(
|
|
9299
9469
|
"The template name or ID to retrieve (e.g., 'Code Feature', 'Bug Fix')."
|
|
9300
9470
|
)
|
|
9301
9471
|
}
|
|
@@ -9325,9 +9495,9 @@ function registerTemplateTools(server2) {
|
|
|
9325
9495
|
{
|
|
9326
9496
|
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
9497
|
inputSchema: {
|
|
9328
|
-
templateName:
|
|
9329
|
-
epicName:
|
|
9330
|
-
variables:
|
|
9498
|
+
templateName: z15.string().describe("The name or ID of the template to preview."),
|
|
9499
|
+
epicName: z15.string().describe("The name to use for the epic that will be created."),
|
|
9500
|
+
variables: z15.record(z15.string(), z15.string()).optional().describe(
|
|
9331
9501
|
"Key-value pairs for variable substitution. Variables in templates use {{variableName}} syntax. For example: { topic: 'Payment Processing' } will replace {{topic}} with 'Payment Processing'."
|
|
9332
9502
|
)
|
|
9333
9503
|
}
|
|
@@ -9375,21 +9545,21 @@ function registerTemplateTools(server2) {
|
|
|
9375
9545
|
{
|
|
9376
9546
|
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
9547
|
inputSchema: {
|
|
9378
|
-
templateName:
|
|
9379
|
-
epicName:
|
|
9380
|
-
team:
|
|
9548
|
+
templateName: z15.string().describe("The name or ID of the template to use."),
|
|
9549
|
+
epicName: z15.string().min(1).describe("The name for the new epic."),
|
|
9550
|
+
team: z15.string().describe(
|
|
9381
9551
|
"The team to create the epic in. Accepts team ID (UUID), name, or key (e.g., 'Engineering', 'ENG')."
|
|
9382
9552
|
),
|
|
9383
|
-
variables:
|
|
9553
|
+
variables: z15.record(z15.string(), z15.string()).optional().describe(
|
|
9384
9554
|
"Key-value pairs for variable substitution. Variables in templates use {{variableName}} syntax."
|
|
9385
9555
|
),
|
|
9386
|
-
epicDescription:
|
|
9387
|
-
epicIcon:
|
|
9388
|
-
epicColor:
|
|
9389
|
-
epicRequestId:
|
|
9556
|
+
epicDescription: z15.string().optional().describe("Custom description for the epic. Overrides template default."),
|
|
9557
|
+
epicIcon: z15.string().optional().describe("Custom icon for the epic. Overrides template default."),
|
|
9558
|
+
epicColor: z15.string().optional().describe("Custom color (hex code) for the epic. Overrides template default."),
|
|
9559
|
+
epicRequestId: z15.string().uuid().optional().describe(
|
|
9390
9560
|
"UUID of an approved Epic Request to link to this epic. When provided, the Epic Request will be marked as converted."
|
|
9391
9561
|
),
|
|
9392
|
-
bypassGovernance:
|
|
9562
|
+
bypassGovernance: z15.boolean().optional()
|
|
9393
9563
|
}
|
|
9394
9564
|
},
|
|
9395
9565
|
async (input) => {
|
|
@@ -9460,11 +9630,11 @@ function registerTemplateTools(server2) {
|
|
|
9460
9630
|
{
|
|
9461
9631
|
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
9632
|
inputSchema: {
|
|
9463
|
-
epicId:
|
|
9633
|
+
epicId: z15.string().describe(
|
|
9464
9634
|
"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
9635
|
),
|
|
9466
|
-
templateName:
|
|
9467
|
-
description:
|
|
9636
|
+
templateName: z15.string().min(1).max(255).describe("The name for the new template. Must be unique."),
|
|
9637
|
+
description: z15.string().max(5e3).optional().describe("Optional description of the template.")
|
|
9468
9638
|
}
|
|
9469
9639
|
},
|
|
9470
9640
|
async (input) => {
|
|
@@ -9507,7 +9677,7 @@ function registerTemplateTools(server2) {
|
|
|
9507
9677
|
}
|
|
9508
9678
|
|
|
9509
9679
|
// src/tools/structured-desc.ts
|
|
9510
|
-
import { z as
|
|
9680
|
+
import { z as z16 } from "zod";
|
|
9511
9681
|
var SECTION_NAMES = [
|
|
9512
9682
|
"summary",
|
|
9513
9683
|
"aiInstructions",
|
|
@@ -9523,80 +9693,80 @@ var SECTION_NAMES = [
|
|
|
9523
9693
|
"estimatedEffort"
|
|
9524
9694
|
];
|
|
9525
9695
|
var baseSchema = {
|
|
9526
|
-
id:
|
|
9696
|
+
id: z16.string().describe(
|
|
9527
9697
|
"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
9698
|
),
|
|
9529
|
-
type:
|
|
9699
|
+
type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'.")
|
|
9530
9700
|
};
|
|
9531
9701
|
function registerStructuredDescTools(server2) {
|
|
9532
9702
|
server2.registerTool(
|
|
9533
9703
|
"compbox__manage_description",
|
|
9534
9704
|
{
|
|
9535
9705
|
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:
|
|
9706
|
+
inputSchema: z16.discriminatedUnion("action", [
|
|
9537
9707
|
// Action: get
|
|
9538
|
-
|
|
9539
|
-
action:
|
|
9708
|
+
z16.object({
|
|
9709
|
+
action: z16.literal("get"),
|
|
9540
9710
|
...baseSchema
|
|
9541
9711
|
}),
|
|
9542
9712
|
// Action: set
|
|
9543
|
-
|
|
9544
|
-
action:
|
|
9713
|
+
z16.object({
|
|
9714
|
+
action: z16.literal("set"),
|
|
9545
9715
|
...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:
|
|
9716
|
+
structuredDesc: z16.object({
|
|
9717
|
+
summary: z16.string().describe("Required: Human-readable summary"),
|
|
9718
|
+
aiInstructions: z16.string().optional().describe("Instructions specifically for AI agents"),
|
|
9719
|
+
acceptanceCriteria: z16.array(z16.string()).optional().describe("List of acceptance criteria"),
|
|
9720
|
+
filesInvolved: z16.array(z16.string()).optional().describe("File paths involved"),
|
|
9721
|
+
functionsToModify: z16.array(z16.string()).optional().describe("Functions to modify (format: 'file:function')"),
|
|
9722
|
+
testingStrategy: z16.string().optional().describe("Testing approach"),
|
|
9723
|
+
testFiles: z16.array(z16.string()).optional().describe("Test file paths"),
|
|
9724
|
+
relatedItemIds: z16.array(z16.string()).optional().describe("Related feature/task IDs"),
|
|
9725
|
+
externalLinks: z16.array(z16.object({
|
|
9726
|
+
url: z16.string(),
|
|
9727
|
+
title: z16.string()
|
|
9558
9728
|
})).optional().describe("External documentation links"),
|
|
9559
|
-
technicalNotes:
|
|
9560
|
-
riskLevel:
|
|
9561
|
-
estimatedEffort:
|
|
9729
|
+
technicalNotes: z16.string().optional().describe("Technical implementation notes"),
|
|
9730
|
+
riskLevel: z16.enum(["low", "medium", "high"]).optional().describe("Risk assessment"),
|
|
9731
|
+
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
9732
|
}),
|
|
9563
|
-
skipValidation:
|
|
9733
|
+
skipValidation: z16.boolean().optional().describe(
|
|
9564
9734
|
"If true, bypasses validation requirements. Use with caution - validation ensures structured descriptions meet minimum quality standards."
|
|
9565
9735
|
)
|
|
9566
9736
|
}),
|
|
9567
9737
|
// Action: update_section
|
|
9568
|
-
|
|
9569
|
-
action:
|
|
9738
|
+
z16.object({
|
|
9739
|
+
action: z16.literal("update_section"),
|
|
9570
9740
|
...baseSchema,
|
|
9571
|
-
section:
|
|
9741
|
+
section: z16.enum(SECTION_NAMES).describe(
|
|
9572
9742
|
"Section to update: summary, aiInstructions, acceptanceCriteria, filesInvolved, functionsToModify, testingStrategy, testFiles, relatedItemIds, externalLinks, technicalNotes, riskLevel, estimatedEffort"
|
|
9573
9743
|
),
|
|
9574
|
-
value:
|
|
9744
|
+
value: z16.unknown().describe(
|
|
9575
9745
|
"New value (type varies by section: string, string[], object[], or enum)"
|
|
9576
9746
|
)
|
|
9577
9747
|
}),
|
|
9578
9748
|
// Action: add_criterion
|
|
9579
|
-
|
|
9580
|
-
action:
|
|
9749
|
+
z16.object({
|
|
9750
|
+
action: z16.literal("add_criterion"),
|
|
9581
9751
|
...baseSchema,
|
|
9582
|
-
criterion:
|
|
9752
|
+
criterion: z16.string().min(1).max(1e3).describe(
|
|
9583
9753
|
"Acceptance criterion to add (e.g., 'All unit tests pass')"
|
|
9584
9754
|
)
|
|
9585
9755
|
}),
|
|
9586
9756
|
// Action: link_file
|
|
9587
|
-
|
|
9588
|
-
action:
|
|
9757
|
+
z16.object({
|
|
9758
|
+
action: z16.literal("link_file"),
|
|
9589
9759
|
...baseSchema,
|
|
9590
|
-
filePath:
|
|
9760
|
+
filePath: z16.string().min(1).max(500).describe(
|
|
9591
9761
|
"File path to link (e.g., 'src/services/user.ts')"
|
|
9592
9762
|
)
|
|
9593
9763
|
}),
|
|
9594
9764
|
// Action: add_link
|
|
9595
|
-
|
|
9596
|
-
action:
|
|
9765
|
+
z16.object({
|
|
9766
|
+
action: z16.literal("add_link"),
|
|
9597
9767
|
...baseSchema,
|
|
9598
|
-
url:
|
|
9599
|
-
title:
|
|
9768
|
+
url: z16.string().url().describe("URL to link"),
|
|
9769
|
+
title: z16.string().min(1).max(255).describe("Descriptive title for the link")
|
|
9600
9770
|
})
|
|
9601
9771
|
])
|
|
9602
9772
|
},
|
|
@@ -9810,10 +9980,10 @@ To bypass validation, set skipValidation: true. However, this is not recommended
|
|
|
9810
9980
|
{
|
|
9811
9981
|
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
9982
|
inputSchema: {
|
|
9813
|
-
id:
|
|
9983
|
+
id: z16.string().describe(
|
|
9814
9984
|
"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
9985
|
),
|
|
9816
|
-
type:
|
|
9986
|
+
type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'.")
|
|
9817
9987
|
}
|
|
9818
9988
|
},
|
|
9819
9989
|
async (input) => {
|
|
@@ -9860,26 +10030,26 @@ To bypass validation, set skipValidation: true. However, this is not recommended
|
|
|
9860
10030
|
{
|
|
9861
10031
|
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
10032
|
inputSchema: {
|
|
9863
|
-
id:
|
|
10033
|
+
id: z16.string().describe(
|
|
9864
10034
|
"The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
9865
10035
|
),
|
|
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:
|
|
10036
|
+
type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
|
|
10037
|
+
structuredDesc: z16.object({
|
|
10038
|
+
summary: z16.string().describe("Required: Human-readable summary"),
|
|
10039
|
+
aiInstructions: z16.string().optional().describe("Instructions specifically for AI agents"),
|
|
10040
|
+
acceptanceCriteria: z16.array(z16.string()).optional().describe("List of acceptance criteria"),
|
|
10041
|
+
filesInvolved: z16.array(z16.string()).optional().describe("File paths involved"),
|
|
10042
|
+
functionsToModify: z16.array(z16.string()).optional().describe("Functions to modify (format: 'file:function')"),
|
|
10043
|
+
testingStrategy: z16.string().optional().describe("Testing approach"),
|
|
10044
|
+
testFiles: z16.array(z16.string()).optional().describe("Test file paths"),
|
|
10045
|
+
relatedItemIds: z16.array(z16.string()).optional().describe("Related feature/task IDs"),
|
|
10046
|
+
externalLinks: z16.array(z16.object({
|
|
10047
|
+
url: z16.string(),
|
|
10048
|
+
title: z16.string()
|
|
9879
10049
|
})).optional().describe("External documentation links"),
|
|
9880
|
-
technicalNotes:
|
|
9881
|
-
riskLevel:
|
|
9882
|
-
estimatedEffort:
|
|
10050
|
+
technicalNotes: z16.string().optional().describe("Technical implementation notes"),
|
|
10051
|
+
riskLevel: z16.enum(["low", "medium", "high"]).optional().describe("Risk assessment"),
|
|
10052
|
+
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
10053
|
}).describe("The structured description object")
|
|
9884
10054
|
}
|
|
9885
10055
|
},
|
|
@@ -9939,14 +10109,14 @@ To bypass validation, set skipValidation: true. However, this is not recommended
|
|
|
9939
10109
|
{
|
|
9940
10110
|
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
10111
|
inputSchema: {
|
|
9942
|
-
id:
|
|
10112
|
+
id: z16.string().describe(
|
|
9943
10113
|
"The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
9944
10114
|
),
|
|
9945
|
-
type:
|
|
9946
|
-
section:
|
|
10115
|
+
type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
|
|
10116
|
+
section: z16.enum(SECTION_NAMES).describe(
|
|
9947
10117
|
"The section to update: summary, aiInstructions, acceptanceCriteria, filesInvolved, functionsToModify, testingStrategy, testFiles, relatedItemIds, externalLinks, technicalNotes, riskLevel, estimatedEffort"
|
|
9948
10118
|
),
|
|
9949
|
-
value:
|
|
10119
|
+
value: z16.unknown().describe(
|
|
9950
10120
|
"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
10121
|
)
|
|
9952
10122
|
}
|
|
@@ -10010,11 +10180,11 @@ To bypass validation, set skipValidation: true. However, this is not recommended
|
|
|
10010
10180
|
{
|
|
10011
10181
|
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
10182
|
inputSchema: {
|
|
10013
|
-
id:
|
|
10183
|
+
id: z16.string().describe(
|
|
10014
10184
|
"The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
10015
10185
|
),
|
|
10016
|
-
type:
|
|
10017
|
-
criterion:
|
|
10186
|
+
type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
|
|
10187
|
+
criterion: z16.string().min(1).max(1e3).describe("The acceptance criterion to add (e.g., 'All unit tests pass')")
|
|
10018
10188
|
}
|
|
10019
10189
|
},
|
|
10020
10190
|
async (input) => {
|
|
@@ -10076,11 +10246,11 @@ To bypass validation, set skipValidation: true. However, this is not recommended
|
|
|
10076
10246
|
{
|
|
10077
10247
|
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
10248
|
inputSchema: {
|
|
10079
|
-
id:
|
|
10249
|
+
id: z16.string().describe(
|
|
10080
10250
|
"The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
10081
10251
|
),
|
|
10082
|
-
type:
|
|
10083
|
-
filePath:
|
|
10252
|
+
type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
|
|
10253
|
+
filePath: z16.string().min(1).max(500).describe("The file path to link (e.g., 'src/services/user.ts')")
|
|
10084
10254
|
}
|
|
10085
10255
|
},
|
|
10086
10256
|
async (input) => {
|
|
@@ -10133,12 +10303,12 @@ To bypass validation, set skipValidation: true. However, this is not recommended
|
|
|
10133
10303
|
{
|
|
10134
10304
|
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
10305
|
inputSchema: {
|
|
10136
|
-
id:
|
|
10306
|
+
id: z16.string().describe(
|
|
10137
10307
|
"The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
10138
10308
|
),
|
|
10139
|
-
type:
|
|
10140
|
-
url:
|
|
10141
|
-
title:
|
|
10309
|
+
type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
|
|
10310
|
+
url: z16.string().url().describe("The URL to link (e.g., 'https://docs.example.com/feature')"),
|
|
10311
|
+
title: z16.string().min(1).max(255).describe("A descriptive title for the link")
|
|
10142
10312
|
}
|
|
10143
10313
|
},
|
|
10144
10314
|
async (input) => {
|
|
@@ -10190,62 +10360,62 @@ To bypass validation, set skipValidation: true. However, this is not recommended
|
|
|
10190
10360
|
}
|
|
10191
10361
|
|
|
10192
10362
|
// src/tools/code-context.ts
|
|
10193
|
-
import { z as
|
|
10363
|
+
import { z as z17 } from "zod";
|
|
10194
10364
|
function registerCodeContextTools(server2) {
|
|
10195
10365
|
server2.registerTool(
|
|
10196
10366
|
"compbox__manage_code_context",
|
|
10197
10367
|
{
|
|
10198
10368
|
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:
|
|
10369
|
+
inputSchema: z17.discriminatedUnion("action", [
|
|
10200
10370
|
// get_context action
|
|
10201
|
-
|
|
10202
|
-
action:
|
|
10203
|
-
id:
|
|
10204
|
-
type:
|
|
10371
|
+
z17.object({
|
|
10372
|
+
action: z17.literal("get_context").describe("Get all code artifacts"),
|
|
10373
|
+
id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
10374
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'")
|
|
10205
10375
|
}),
|
|
10206
10376
|
// link_file action
|
|
10207
|
-
|
|
10208
|
-
action:
|
|
10209
|
-
id:
|
|
10210
|
-
type:
|
|
10211
|
-
filePath:
|
|
10377
|
+
z17.object({
|
|
10378
|
+
action: z17.literal("link_file").describe("Link a file to the work item"),
|
|
10379
|
+
id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
10380
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
10381
|
+
filePath: z17.string().min(1).max(500).describe("File path to link (e.g., 'src/services/user.ts')")
|
|
10212
10382
|
}),
|
|
10213
10383
|
// unlink_file action
|
|
10214
|
-
|
|
10215
|
-
action:
|
|
10216
|
-
id:
|
|
10217
|
-
type:
|
|
10218
|
-
filePath:
|
|
10384
|
+
z17.object({
|
|
10385
|
+
action: z17.literal("unlink_file").describe("Unlink a file from the work item"),
|
|
10386
|
+
id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
10387
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
10388
|
+
filePath: z17.string().min(1).max(500).describe("File path to unlink")
|
|
10219
10389
|
}),
|
|
10220
10390
|
// link_function action
|
|
10221
|
-
|
|
10222
|
-
action:
|
|
10223
|
-
id:
|
|
10224
|
-
type:
|
|
10225
|
-
filePath:
|
|
10226
|
-
functionName:
|
|
10391
|
+
z17.object({
|
|
10392
|
+
action: z17.literal("link_function").describe("Link a function to the work item"),
|
|
10393
|
+
id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
10394
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
10395
|
+
filePath: z17.string().min(1).max(500).describe("File path containing the function"),
|
|
10396
|
+
functionName: z17.string().min(1).max(200).describe("Name of the function")
|
|
10227
10397
|
}),
|
|
10228
10398
|
// link_branch action
|
|
10229
|
-
|
|
10230
|
-
action:
|
|
10231
|
-
id:
|
|
10232
|
-
type:
|
|
10233
|
-
branchName:
|
|
10399
|
+
z17.object({
|
|
10400
|
+
action: z17.literal("link_branch").describe("Link a git branch to the work item"),
|
|
10401
|
+
id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
10402
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
10403
|
+
branchName: z17.string().min(1).max(255).describe("Git branch name (e.g., 'feature/COM-7-integration')")
|
|
10234
10404
|
}),
|
|
10235
10405
|
// link_commit action
|
|
10236
|
-
|
|
10237
|
-
action:
|
|
10238
|
-
id:
|
|
10239
|
-
type:
|
|
10240
|
-
commitSha:
|
|
10406
|
+
z17.object({
|
|
10407
|
+
action: z17.literal("link_commit").describe("Link a git commit to the work item"),
|
|
10408
|
+
id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
10409
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
10410
|
+
commitSha: z17.string().min(7).max(40).describe("Git commit SHA (short or full, e.g., 'abc1234')")
|
|
10241
10411
|
}),
|
|
10242
10412
|
// link_pr action
|
|
10243
|
-
|
|
10244
|
-
action:
|
|
10245
|
-
id:
|
|
10246
|
-
type:
|
|
10247
|
-
prNumber:
|
|
10248
|
-
prUrl:
|
|
10413
|
+
z17.object({
|
|
10414
|
+
action: z17.literal("link_pr").describe("Link a pull request to the work item"),
|
|
10415
|
+
id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
|
|
10416
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
|
|
10417
|
+
prNumber: z17.number().int().positive().describe("Pull request number"),
|
|
10418
|
+
prUrl: z17.string().url().max(2048).describe("Full URL to the pull request")
|
|
10249
10419
|
})
|
|
10250
10420
|
])
|
|
10251
10421
|
},
|
|
@@ -10414,10 +10584,10 @@ function registerCodeContextTools(server2) {
|
|
|
10414
10584
|
{
|
|
10415
10585
|
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
10586
|
inputSchema: {
|
|
10417
|
-
id:
|
|
10587
|
+
id: z17.string().describe(
|
|
10418
10588
|
"The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
|
|
10419
10589
|
),
|
|
10420
|
-
type:
|
|
10590
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'.")
|
|
10421
10591
|
}
|
|
10422
10592
|
},
|
|
10423
10593
|
async (input) => {
|
|
@@ -10445,11 +10615,11 @@ function registerCodeContextTools(server2) {
|
|
|
10445
10615
|
{
|
|
10446
10616
|
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
10617
|
inputSchema: {
|
|
10448
|
-
id:
|
|
10618
|
+
id: z17.string().describe(
|
|
10449
10619
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10450
10620
|
),
|
|
10451
|
-
type:
|
|
10452
|
-
filePath:
|
|
10621
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
|
|
10622
|
+
filePath: z17.string().min(1).max(500).describe("The file path to link (e.g., 'src/services/user.ts')")
|
|
10453
10623
|
}
|
|
10454
10624
|
},
|
|
10455
10625
|
async (input) => {
|
|
@@ -10483,11 +10653,11 @@ function registerCodeContextTools(server2) {
|
|
|
10483
10653
|
{
|
|
10484
10654
|
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
10655
|
inputSchema: {
|
|
10486
|
-
id:
|
|
10656
|
+
id: z17.string().describe(
|
|
10487
10657
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10488
10658
|
),
|
|
10489
|
-
type:
|
|
10490
|
-
filePath:
|
|
10659
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
|
|
10660
|
+
filePath: z17.string().min(1).max(500).describe("The file path to unlink")
|
|
10491
10661
|
}
|
|
10492
10662
|
},
|
|
10493
10663
|
async (input) => {
|
|
@@ -10521,12 +10691,12 @@ function registerCodeContextTools(server2) {
|
|
|
10521
10691
|
{
|
|
10522
10692
|
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
10693
|
inputSchema: {
|
|
10524
|
-
id:
|
|
10694
|
+
id: z17.string().describe(
|
|
10525
10695
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10526
10696
|
),
|
|
10527
|
-
type:
|
|
10528
|
-
filePath:
|
|
10529
|
-
functionName:
|
|
10697
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
|
|
10698
|
+
filePath: z17.string().min(1).max(500).describe("The file path containing the function"),
|
|
10699
|
+
functionName: z17.string().min(1).max(200).describe("The name of the function")
|
|
10530
10700
|
}
|
|
10531
10701
|
},
|
|
10532
10702
|
async (input) => {
|
|
@@ -10568,11 +10738,11 @@ function registerCodeContextTools(server2) {
|
|
|
10568
10738
|
{
|
|
10569
10739
|
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
10740
|
inputSchema: {
|
|
10571
|
-
id:
|
|
10741
|
+
id: z17.string().describe(
|
|
10572
10742
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10573
10743
|
),
|
|
10574
|
-
type:
|
|
10575
|
-
branchName:
|
|
10744
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
|
|
10745
|
+
branchName: z17.string().min(1).max(255).describe("The git branch name (e.g., 'feature/COM-7-codebase-integration')")
|
|
10576
10746
|
}
|
|
10577
10747
|
},
|
|
10578
10748
|
async (input) => {
|
|
@@ -10606,11 +10776,11 @@ function registerCodeContextTools(server2) {
|
|
|
10606
10776
|
{
|
|
10607
10777
|
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
10778
|
inputSchema: {
|
|
10609
|
-
id:
|
|
10779
|
+
id: z17.string().describe(
|
|
10610
10780
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10611
10781
|
),
|
|
10612
|
-
type:
|
|
10613
|
-
commitSha:
|
|
10782
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
|
|
10783
|
+
commitSha: z17.string().min(7).max(40).describe("The git commit SHA (short or full, e.g., 'abc1234')")
|
|
10614
10784
|
}
|
|
10615
10785
|
},
|
|
10616
10786
|
async (input) => {
|
|
@@ -10644,12 +10814,12 @@ function registerCodeContextTools(server2) {
|
|
|
10644
10814
|
{
|
|
10645
10815
|
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
10816
|
inputSchema: {
|
|
10647
|
-
id:
|
|
10817
|
+
id: z17.string().describe(
|
|
10648
10818
|
"The feature or task identifier. Accepts UUID or human-readable identifier."
|
|
10649
10819
|
),
|
|
10650
|
-
type:
|
|
10651
|
-
prNumber:
|
|
10652
|
-
prUrl:
|
|
10820
|
+
type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
|
|
10821
|
+
prNumber: z17.number().int().positive().describe("The pull request number"),
|
|
10822
|
+
prUrl: z17.string().url().max(2048).describe("The full URL to the pull request")
|
|
10653
10823
|
}
|
|
10654
10824
|
},
|
|
10655
10825
|
async (input) => {
|
|
@@ -10689,7 +10859,7 @@ function registerCodeContextTools(server2) {
|
|
|
10689
10859
|
}
|
|
10690
10860
|
|
|
10691
10861
|
// src/tools/validations.ts
|
|
10692
|
-
import { z as
|
|
10862
|
+
import { z as z18 } from "zod";
|
|
10693
10863
|
var validationCheckTypes = [
|
|
10694
10864
|
"command",
|
|
10695
10865
|
"file_exists",
|
|
@@ -10702,56 +10872,56 @@ function registerValidationTools(server2) {
|
|
|
10702
10872
|
"compbox__manage_validations",
|
|
10703
10873
|
{
|
|
10704
10874
|
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:
|
|
10875
|
+
inputSchema: z18.discriminatedUnion("action", [
|
|
10706
10876
|
// Add validation
|
|
10707
|
-
|
|
10708
|
-
action:
|
|
10709
|
-
taskId:
|
|
10710
|
-
type:
|
|
10711
|
-
description:
|
|
10712
|
-
command:
|
|
10713
|
-
expectedExitCode:
|
|
10714
|
-
timeoutMs:
|
|
10715
|
-
filePath:
|
|
10716
|
-
searchPattern:
|
|
10717
|
-
testCommand:
|
|
10877
|
+
z18.object({
|
|
10878
|
+
action: z18.literal("add"),
|
|
10879
|
+
taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
|
|
10880
|
+
type: z18.enum(validationCheckTypes).describe("Validation check type"),
|
|
10881
|
+
description: z18.string().min(1).max(500).describe("What this check validates"),
|
|
10882
|
+
command: z18.string().max(1e3).optional().describe("Shell command (for 'command' type)"),
|
|
10883
|
+
expectedExitCode: z18.number().int().min(0).max(255).optional().describe("Expected exit code (default: 0)"),
|
|
10884
|
+
timeoutMs: z18.number().int().min(1e3).max(3e5).optional().describe("Timeout in ms (default: 30000)"),
|
|
10885
|
+
filePath: z18.string().max(500).optional().describe("File path (for 'file_exists' or 'file_contains')"),
|
|
10886
|
+
searchPattern: z18.string().max(1e3).optional().describe("Regex pattern (for 'file_contains')"),
|
|
10887
|
+
testCommand: z18.string().max(1e3).optional().describe("Test command (for 'test_passes')")
|
|
10718
10888
|
}),
|
|
10719
10889
|
// List validations
|
|
10720
|
-
|
|
10721
|
-
action:
|
|
10722
|
-
taskId:
|
|
10890
|
+
z18.object({
|
|
10891
|
+
action: z18.literal("list"),
|
|
10892
|
+
taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')")
|
|
10723
10893
|
}),
|
|
10724
10894
|
// Run single validation
|
|
10725
|
-
|
|
10726
|
-
action:
|
|
10727
|
-
taskId:
|
|
10728
|
-
checkId:
|
|
10729
|
-
workingDirectory:
|
|
10895
|
+
z18.object({
|
|
10896
|
+
action: z18.literal("run"),
|
|
10897
|
+
taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
|
|
10898
|
+
checkId: z18.string().uuid().describe("Validation check ID"),
|
|
10899
|
+
workingDirectory: z18.string().max(1e3).optional().describe("Working directory for command execution")
|
|
10730
10900
|
}),
|
|
10731
10901
|
// Run all validations
|
|
10732
|
-
|
|
10733
|
-
action:
|
|
10734
|
-
taskId:
|
|
10735
|
-
stopOnFailure:
|
|
10736
|
-
workingDirectory:
|
|
10902
|
+
z18.object({
|
|
10903
|
+
action: z18.literal("run_all"),
|
|
10904
|
+
taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
|
|
10905
|
+
stopOnFailure: z18.boolean().optional().describe("Stop after first failure (default: false)"),
|
|
10906
|
+
workingDirectory: z18.string().max(1e3).optional().describe("Working directory for command execution")
|
|
10737
10907
|
}),
|
|
10738
10908
|
// Mark manual validated
|
|
10739
|
-
|
|
10740
|
-
action:
|
|
10741
|
-
taskId:
|
|
10742
|
-
checkId:
|
|
10743
|
-
notes:
|
|
10909
|
+
z18.object({
|
|
10910
|
+
action: z18.literal("mark_manual"),
|
|
10911
|
+
taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
|
|
10912
|
+
checkId: z18.string().uuid().describe("Manual validation check ID"),
|
|
10913
|
+
notes: z18.string().max(1e3).optional().describe("Notes about manual verification")
|
|
10744
10914
|
}),
|
|
10745
10915
|
// Remove validation
|
|
10746
|
-
|
|
10747
|
-
action:
|
|
10748
|
-
taskId:
|
|
10749
|
-
checkId:
|
|
10916
|
+
z18.object({
|
|
10917
|
+
action: z18.literal("remove"),
|
|
10918
|
+
taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
|
|
10919
|
+
checkId: z18.string().uuid().describe("Validation check ID to remove")
|
|
10750
10920
|
}),
|
|
10751
10921
|
// Reset validations
|
|
10752
|
-
|
|
10753
|
-
action:
|
|
10754
|
-
taskId:
|
|
10922
|
+
z18.object({
|
|
10923
|
+
action: z18.literal("reset"),
|
|
10924
|
+
taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')")
|
|
10755
10925
|
})
|
|
10756
10926
|
])
|
|
10757
10927
|
},
|
|
@@ -10841,31 +11011,31 @@ function registerValidationTools(server2) {
|
|
|
10841
11011
|
{
|
|
10842
11012
|
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
11013
|
inputSchema: {
|
|
10844
|
-
taskId:
|
|
11014
|
+
taskId: z18.string().describe(
|
|
10845
11015
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
10846
11016
|
),
|
|
10847
|
-
type:
|
|
11017
|
+
type: z18.enum(validationCheckTypes).describe(
|
|
10848
11018
|
"The type of validation check."
|
|
10849
11019
|
),
|
|
10850
|
-
description:
|
|
11020
|
+
description: z18.string().min(1).max(500).describe(
|
|
10851
11021
|
"Human-readable description of what this check validates."
|
|
10852
11022
|
),
|
|
10853
|
-
command:
|
|
11023
|
+
command: z18.string().max(1e3).optional().describe(
|
|
10854
11024
|
"Shell command to run (required for 'command' type). E.g., 'pnpm lint'."
|
|
10855
11025
|
),
|
|
10856
|
-
expectedExitCode:
|
|
11026
|
+
expectedExitCode: z18.number().int().min(0).max(255).optional().describe(
|
|
10857
11027
|
"Expected exit code for command (default: 0)."
|
|
10858
11028
|
),
|
|
10859
|
-
timeoutMs:
|
|
11029
|
+
timeoutMs: z18.number().int().min(1e3).max(3e5).optional().describe(
|
|
10860
11030
|
"Timeout in milliseconds (default: 30000, max: 300000)."
|
|
10861
11031
|
),
|
|
10862
|
-
filePath:
|
|
11032
|
+
filePath: z18.string().max(500).optional().describe(
|
|
10863
11033
|
"File path for 'file_exists' or 'file_contains' checks."
|
|
10864
11034
|
),
|
|
10865
|
-
searchPattern:
|
|
11035
|
+
searchPattern: z18.string().max(1e3).optional().describe(
|
|
10866
11036
|
"Regex pattern for 'file_contains' check."
|
|
10867
11037
|
),
|
|
10868
|
-
testCommand:
|
|
11038
|
+
testCommand: z18.string().max(1e3).optional().describe(
|
|
10869
11039
|
"Test command for 'test_passes' type. E.g., 'pnpm test --filter auth'."
|
|
10870
11040
|
)
|
|
10871
11041
|
}
|
|
@@ -10902,7 +11072,7 @@ function registerValidationTools(server2) {
|
|
|
10902
11072
|
{
|
|
10903
11073
|
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
11074
|
inputSchema: {
|
|
10905
|
-
taskId:
|
|
11075
|
+
taskId: z18.string().describe(
|
|
10906
11076
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
10907
11077
|
)
|
|
10908
11078
|
}
|
|
@@ -10926,13 +11096,13 @@ function registerValidationTools(server2) {
|
|
|
10926
11096
|
{
|
|
10927
11097
|
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
11098
|
inputSchema: {
|
|
10929
|
-
taskId:
|
|
11099
|
+
taskId: z18.string().describe(
|
|
10930
11100
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
10931
11101
|
),
|
|
10932
|
-
checkId:
|
|
11102
|
+
checkId: z18.string().uuid().describe(
|
|
10933
11103
|
"The ID of the validation check to run."
|
|
10934
11104
|
),
|
|
10935
|
-
workingDirectory:
|
|
11105
|
+
workingDirectory: z18.string().max(1e3).optional().describe(
|
|
10936
11106
|
"Working directory for command execution (defaults to cwd)."
|
|
10937
11107
|
)
|
|
10938
11108
|
}
|
|
@@ -10960,13 +11130,13 @@ function registerValidationTools(server2) {
|
|
|
10960
11130
|
{
|
|
10961
11131
|
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
11132
|
inputSchema: {
|
|
10963
|
-
taskId:
|
|
11133
|
+
taskId: z18.string().describe(
|
|
10964
11134
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
10965
11135
|
),
|
|
10966
|
-
stopOnFailure:
|
|
11136
|
+
stopOnFailure: z18.boolean().optional().describe(
|
|
10967
11137
|
"If true, stops running checks after the first failure (default: false)."
|
|
10968
11138
|
),
|
|
10969
|
-
workingDirectory:
|
|
11139
|
+
workingDirectory: z18.string().max(1e3).optional().describe(
|
|
10970
11140
|
"Working directory for command execution (defaults to cwd)."
|
|
10971
11141
|
)
|
|
10972
11142
|
}
|
|
@@ -10993,13 +11163,13 @@ function registerValidationTools(server2) {
|
|
|
10993
11163
|
{
|
|
10994
11164
|
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
11165
|
inputSchema: {
|
|
10996
|
-
taskId:
|
|
11166
|
+
taskId: z18.string().describe(
|
|
10997
11167
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
10998
11168
|
),
|
|
10999
|
-
checkId:
|
|
11169
|
+
checkId: z18.string().uuid().describe(
|
|
11000
11170
|
"The ID of the manual validation check to mark as validated."
|
|
11001
11171
|
),
|
|
11002
|
-
notes:
|
|
11172
|
+
notes: z18.string().max(1e3).optional().describe(
|
|
11003
11173
|
"Optional notes about the manual verification."
|
|
11004
11174
|
)
|
|
11005
11175
|
}
|
|
@@ -11030,10 +11200,10 @@ function registerValidationTools(server2) {
|
|
|
11030
11200
|
{
|
|
11031
11201
|
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
11202
|
inputSchema: {
|
|
11033
|
-
taskId:
|
|
11203
|
+
taskId: z18.string().describe(
|
|
11034
11204
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
11035
11205
|
),
|
|
11036
|
-
checkId:
|
|
11206
|
+
checkId: z18.string().uuid().describe(
|
|
11037
11207
|
"The ID of the validation check to remove."
|
|
11038
11208
|
)
|
|
11039
11209
|
}
|
|
@@ -11062,7 +11232,7 @@ function registerValidationTools(server2) {
|
|
|
11062
11232
|
{
|
|
11063
11233
|
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
11234
|
inputSchema: {
|
|
11065
|
-
taskId:
|
|
11235
|
+
taskId: z18.string().describe(
|
|
11066
11236
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
11067
11237
|
)
|
|
11068
11238
|
}
|
|
@@ -11087,14 +11257,14 @@ function registerValidationTools(server2) {
|
|
|
11087
11257
|
}
|
|
11088
11258
|
|
|
11089
11259
|
// src/tools/summary.ts
|
|
11090
|
-
import { z as
|
|
11260
|
+
import { z as z19 } from "zod";
|
|
11091
11261
|
function registerSummaryTools(server2) {
|
|
11092
11262
|
server2.registerTool(
|
|
11093
11263
|
"compbox__get_progress_summary",
|
|
11094
11264
|
{
|
|
11095
11265
|
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
11266
|
inputSchema: {
|
|
11097
|
-
epicId:
|
|
11267
|
+
epicId: z19.string().describe(
|
|
11098
11268
|
"The epic to get progress summary for. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
|
|
11099
11269
|
)
|
|
11100
11270
|
}
|
|
@@ -11149,7 +11319,7 @@ function registerSummaryTools(server2) {
|
|
|
11149
11319
|
{
|
|
11150
11320
|
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
11321
|
inputSchema: {
|
|
11152
|
-
teamId:
|
|
11322
|
+
teamId: z19.string().optional().describe(
|
|
11153
11323
|
"Optional team ID to scope the rollup to that team and all its descendant teams. Omit for the whole organization."
|
|
11154
11324
|
)
|
|
11155
11325
|
}
|
|
@@ -11167,7 +11337,7 @@ function registerSummaryTools(server2) {
|
|
|
11167
11337
|
}
|
|
11168
11338
|
|
|
11169
11339
|
// src/tools/decisions.ts
|
|
11170
|
-
import { z as
|
|
11340
|
+
import { z as z20 } from "zod";
|
|
11171
11341
|
var decisionCategories = [
|
|
11172
11342
|
"architecture",
|
|
11173
11343
|
"library",
|
|
@@ -11184,34 +11354,34 @@ function registerDecisionTools(server2) {
|
|
|
11184
11354
|
{
|
|
11185
11355
|
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
11356
|
inputSchema: {
|
|
11187
|
-
epicId:
|
|
11357
|
+
epicId: z20.string().uuid().describe(
|
|
11188
11358
|
"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
11359
|
),
|
|
11190
|
-
featureId:
|
|
11360
|
+
featureId: z20.string().uuid().optional().describe(
|
|
11191
11361
|
"Optional feature this decision relates to. Use when the decision is specific to a particular feature within the epic."
|
|
11192
11362
|
),
|
|
11193
|
-
taskId:
|
|
11363
|
+
taskId: z20.string().uuid().optional().describe(
|
|
11194
11364
|
"Optional task this decision relates to. Use when the decision is specific to a particular task within a feature."
|
|
11195
11365
|
),
|
|
11196
|
-
question:
|
|
11366
|
+
question: z20.string().min(1).max(1e3).describe(
|
|
11197
11367
|
"What was being decided (required). A clear statement of the decision point. Example: 'Which state management library to use for the dashboard'"
|
|
11198
11368
|
),
|
|
11199
|
-
decision:
|
|
11369
|
+
decision: z20.string().min(1).max(2e3).describe(
|
|
11200
11370
|
"The choice that was made (required). A clear statement of what was decided. Example: 'Use Zustand instead of Redux'"
|
|
11201
11371
|
),
|
|
11202
|
-
rationale:
|
|
11372
|
+
rationale: z20.string().min(1).max(5e3).describe(
|
|
11203
11373
|
"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
11374
|
),
|
|
11205
|
-
alternatives:
|
|
11375
|
+
alternatives: z20.array(z20.string().max(500)).max(10).optional().describe(
|
|
11206
11376
|
"What other options were considered. List alternatives that were evaluated but not chosen. Example: ['Redux', 'MobX', 'Jotai']"
|
|
11207
11377
|
),
|
|
11208
|
-
madeBy:
|
|
11378
|
+
madeBy: z20.string().min(1).max(255).default("AI").describe(
|
|
11209
11379
|
"Who made the decision. Use 'AI' for AI-made decisions, 'human' for user decisions, or a user ID for specific attribution. Default: 'AI'"
|
|
11210
11380
|
),
|
|
11211
|
-
category:
|
|
11381
|
+
category: z20.enum(decisionCategories).optional().describe(
|
|
11212
11382
|
"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
11383
|
),
|
|
11214
|
-
impact:
|
|
11384
|
+
impact: z20.enum(impactLevels).optional().describe(
|
|
11215
11385
|
"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
11386
|
)
|
|
11217
11387
|
}
|
|
@@ -11256,25 +11426,25 @@ function registerDecisionTools(server2) {
|
|
|
11256
11426
|
{
|
|
11257
11427
|
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
11428
|
inputSchema: {
|
|
11259
|
-
epicId:
|
|
11429
|
+
epicId: z20.string().uuid().optional().describe(
|
|
11260
11430
|
"Filter by epic ID. Returns all decisions associated with this epic. Accepts UUID or identifier (e.g., 'ENG-E1')."
|
|
11261
11431
|
),
|
|
11262
|
-
featureId:
|
|
11432
|
+
featureId: z20.string().uuid().optional().describe(
|
|
11263
11433
|
"Filter by feature ID. Returns decisions associated with this feature."
|
|
11264
11434
|
),
|
|
11265
|
-
taskId:
|
|
11435
|
+
taskId: z20.string().uuid().optional().describe(
|
|
11266
11436
|
"Filter by task ID. Returns decisions associated with this task."
|
|
11267
11437
|
),
|
|
11268
|
-
category:
|
|
11438
|
+
category: z20.enum(decisionCategories).optional().describe(
|
|
11269
11439
|
"Filter by decision category (architecture, library, approach, scope, design, tradeoff, deferral)."
|
|
11270
11440
|
),
|
|
11271
|
-
impact:
|
|
11441
|
+
impact: z20.enum(impactLevels).optional().describe(
|
|
11272
11442
|
"Filter by impact level (low, medium, high)."
|
|
11273
11443
|
),
|
|
11274
|
-
limit:
|
|
11444
|
+
limit: z20.number().int().min(1).max(100).optional().describe(
|
|
11275
11445
|
"Maximum number of decisions to return (default: 20, max: 100)."
|
|
11276
11446
|
),
|
|
11277
|
-
cursor:
|
|
11447
|
+
cursor: z20.string().optional().describe(
|
|
11278
11448
|
"Pagination cursor from a previous response."
|
|
11279
11449
|
)
|
|
11280
11450
|
}
|
|
@@ -11309,16 +11479,16 @@ function registerDecisionTools(server2) {
|
|
|
11309
11479
|
{
|
|
11310
11480
|
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
11481
|
inputSchema: {
|
|
11312
|
-
query:
|
|
11482
|
+
query: z20.string().min(1).describe(
|
|
11313
11483
|
"Search query (required). Searches in question, decision, and rationale fields. Example: 'authentication', 'database choice', 'performance optimization'"
|
|
11314
11484
|
),
|
|
11315
|
-
epicId:
|
|
11485
|
+
epicId: z20.string().uuid().optional().describe(
|
|
11316
11486
|
"Optional: Limit search to a specific epic. Accepts UUID or identifier (e.g., 'ENG-E1')."
|
|
11317
11487
|
),
|
|
11318
|
-
limit:
|
|
11488
|
+
limit: z20.number().int().min(1).max(100).optional().describe(
|
|
11319
11489
|
"Maximum number of results (default: 20, max: 100)."
|
|
11320
11490
|
),
|
|
11321
|
-
cursor:
|
|
11491
|
+
cursor: z20.string().optional().describe(
|
|
11322
11492
|
"Pagination cursor from a previous response."
|
|
11323
11493
|
)
|
|
11324
11494
|
}
|
|
@@ -11351,10 +11521,10 @@ function registerDecisionTools(server2) {
|
|
|
11351
11521
|
{
|
|
11352
11522
|
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
11523
|
inputSchema: {
|
|
11354
|
-
taskId:
|
|
11524
|
+
taskId: z20.string().describe(
|
|
11355
11525
|
"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
11526
|
).optional(),
|
|
11357
|
-
featureId:
|
|
11527
|
+
featureId: z20.string().describe(
|
|
11358
11528
|
"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
11529
|
).optional()
|
|
11360
11530
|
}
|
|
@@ -11416,7 +11586,7 @@ function isUuid(value) {
|
|
|
11416
11586
|
}
|
|
11417
11587
|
|
|
11418
11588
|
// src/tools/teams.ts
|
|
11419
|
-
import { z as
|
|
11589
|
+
import { z as z21 } from "zod";
|
|
11420
11590
|
function gcpKeylessGuidance(k) {
|
|
11421
11591
|
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
11592
|
const missing = k.missing.length > 0 ? ` Missing: ${k.missing.join(" ")}` : "";
|
|
@@ -11456,7 +11626,7 @@ function registerTeamTools(server2) {
|
|
|
11456
11626
|
{
|
|
11457
11627
|
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
11628
|
inputSchema: {
|
|
11459
|
-
team:
|
|
11629
|
+
team: z21.string().min(1).describe("The project/team: UUID, name or key (e.g. 'SAISUD').")
|
|
11460
11630
|
}
|
|
11461
11631
|
},
|
|
11462
11632
|
async (input) => {
|
|
@@ -11493,19 +11663,19 @@ function registerTeamTools(server2) {
|
|
|
11493
11663
|
}
|
|
11494
11664
|
|
|
11495
11665
|
// src/tools/team-hierarchy.ts
|
|
11496
|
-
import { z as
|
|
11666
|
+
import { z as z22 } from "zod";
|
|
11497
11667
|
var createTeamChildSchema = {
|
|
11498
|
-
parentId:
|
|
11499
|
-
name:
|
|
11500
|
-
key:
|
|
11501
|
-
level:
|
|
11668
|
+
parentId: z22.string().uuid().describe("The UUID of the parent team that will own the new child team."),
|
|
11669
|
+
name: z22.string().min(1).max(255).describe("Display name for the child team."),
|
|
11670
|
+
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."),
|
|
11671
|
+
level: z22.enum(["group", "product-line", "product", "discipline"]).describe("Hierarchy level for the child team (required).")
|
|
11502
11672
|
};
|
|
11503
11673
|
var getTeamPathSchema = {
|
|
11504
|
-
teamId:
|
|
11674
|
+
teamId: z22.string().uuid().describe("The UUID of the team whose ordered ancestor path should be returned.")
|
|
11505
11675
|
};
|
|
11506
11676
|
var moveTeamSchema = {
|
|
11507
|
-
teamId:
|
|
11508
|
-
newParentId:
|
|
11677
|
+
teamId: z22.string().uuid().describe("The UUID of the team to move within the hierarchy."),
|
|
11678
|
+
newParentId: z22.string().uuid().nullable().describe("The UUID of the new parent team. Pass null to move the team to the root level.")
|
|
11509
11679
|
};
|
|
11510
11680
|
function registerTeamHierarchyTools(server2) {
|
|
11511
11681
|
server2.registerTool(
|
|
@@ -11605,7 +11775,7 @@ function registerTeamHierarchyTools(server2) {
|
|
|
11605
11775
|
|
|
11606
11776
|
// src/tools/composite.ts
|
|
11607
11777
|
init_dist();
|
|
11608
|
-
import { z as
|
|
11778
|
+
import { z as z23 } from "zod";
|
|
11609
11779
|
var COMPOSITE_TIMEOUT_MS = 12e4;
|
|
11610
11780
|
function withTimeout(promise, ms, operationName) {
|
|
11611
11781
|
return new Promise((resolve, reject) => {
|
|
@@ -11631,47 +11801,49 @@ function withTimeout(promise, ms, operationName) {
|
|
|
11631
11801
|
var estimatedComplexityValues = ["trivial", "simple", "moderate", "complex"];
|
|
11632
11802
|
var estimatedEffortValues = ["trivial", "small", "medium", "large", "xl"];
|
|
11633
11803
|
var riskLevelValues = ["low", "medium", "high"];
|
|
11634
|
-
var externalLinkSchema =
|
|
11635
|
-
url:
|
|
11636
|
-
title:
|
|
11804
|
+
var externalLinkSchema = z23.object({
|
|
11805
|
+
url: z23.string().describe("URL of the external resource"),
|
|
11806
|
+
title: z23.string().describe("Display title for the link")
|
|
11637
11807
|
});
|
|
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:
|
|
11808
|
+
var structuredDescSchema = z23.object({
|
|
11809
|
+
summary: z23.string().describe("Brief human-readable summary (required)"),
|
|
11810
|
+
aiInstructions: z23.string().optional().describe("Specific instructions for AI agents implementing this item"),
|
|
11811
|
+
acceptanceCriteria: z23.array(z23.string()).optional().describe("List of acceptance criteria that must be met"),
|
|
11812
|
+
filesInvolved: z23.array(z23.string()).optional().describe("File paths that will be involved in this work"),
|
|
11813
|
+
functionsToModify: z23.array(z23.string()).optional().describe("Functions to modify in format 'filePath:functionName'"),
|
|
11814
|
+
testingStrategy: z23.string().optional().describe("Description of how this work should be tested"),
|
|
11815
|
+
testFiles: z23.array(z23.string()).optional().describe("Test file paths"),
|
|
11816
|
+
relatedItemIds: z23.array(z23.string()).optional().describe("Related feature or task identifiers"),
|
|
11817
|
+
externalLinks: z23.array(externalLinkSchema).optional().describe("External documentation or reference links"),
|
|
11818
|
+
technicalNotes: z23.string().optional().describe("Technical implementation notes or constraints"),
|
|
11819
|
+
riskLevel: z23.enum(riskLevelValues).optional().describe("Risk level assessment: low, medium, or high"),
|
|
11820
|
+
estimatedEffort: z23.enum(estimatedEffortValues).optional().describe("Effort estimate: trivial, small, medium, large, or xl")
|
|
11651
11821
|
});
|
|
11652
|
-
var compositeTaskSchema =
|
|
11653
|
-
title:
|
|
11654
|
-
executionOrder:
|
|
11655
|
-
estimatedComplexity:
|
|
11822
|
+
var compositeTaskSchema = z23.object({
|
|
11823
|
+
title: z23.string().min(1).max(500).describe("Task title (required)"),
|
|
11824
|
+
executionOrder: z23.number().int().positive().optional().describe("Execution order within the feature (1, 2, 3...). Lower numbers first."),
|
|
11825
|
+
estimatedComplexity: z23.enum(estimatedComplexityValues).optional().describe("Complexity: trivial (<1hr), simple (1-4hr), moderate (1-3d), complex (>3d)"),
|
|
11656
11826
|
structuredDesc: structuredDescSchema.optional().describe("Structured description with summary, aiInstructions, acceptanceCriteria, etc.")
|
|
11657
11827
|
});
|
|
11658
|
-
var compositeFeatureSchema =
|
|
11659
|
-
title:
|
|
11660
|
-
executionOrder:
|
|
11661
|
-
estimatedComplexity:
|
|
11662
|
-
canParallelize:
|
|
11663
|
-
parallelGroup:
|
|
11664
|
-
dependencies:
|
|
11828
|
+
var compositeFeatureSchema = z23.object({
|
|
11829
|
+
title: z23.string().min(1).max(500).describe("Feature title (required)"),
|
|
11830
|
+
executionOrder: z23.number().int().positive().describe("Execution order within the epic (required). Lower numbers first."),
|
|
11831
|
+
estimatedComplexity: z23.enum(estimatedComplexityValues).describe("Complexity (required): trivial, simple, moderate, or complex"),
|
|
11832
|
+
canParallelize: z23.boolean().optional().describe("Whether this feature can run alongside other features in parallel"),
|
|
11833
|
+
parallelGroup: z23.string().max(100).optional().describe("Group identifier for features that can run together"),
|
|
11834
|
+
dependencies: z23.array(z23.number().int().min(0)).optional().describe(
|
|
11665
11835
|
"Array of 0-based indices referencing earlier features in this array that must complete first"
|
|
11666
11836
|
),
|
|
11667
11837
|
structuredDesc: structuredDescSchema.optional().describe("Structured description with summary, aiInstructions, acceptanceCriteria, etc."),
|
|
11668
|
-
tasks:
|
|
11838
|
+
tasks: z23.array(compositeTaskSchema).min(1).describe("Array of tasks for this feature (at least 1 required)")
|
|
11669
11839
|
});
|
|
11670
11840
|
function registerCompositeTools(server2) {
|
|
11671
11841
|
server2.registerTool(
|
|
11672
11842
|
"compbox__create_epic_complete",
|
|
11673
11843
|
{
|
|
11674
|
-
description: `IMPORTANT:
|
|
11844
|
+
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.
|
|
11845
|
+
|
|
11846
|
+
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
11847
|
|
|
11676
11848
|
Create an epic with all features, tasks, and structured descriptions in a single atomic operation.
|
|
11677
11849
|
|
|
@@ -11695,19 +11867,19 @@ Use this instead of individual create calls when building a complete implementat
|
|
|
11695
11867
|
|
|
11696
11868
|
Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
|
|
11697
11869
|
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:
|
|
11870
|
+
name: z23.string().min(1).max(255).describe("Epic name (required)"),
|
|
11871
|
+
team: z23.string().min(1).describe("Team ID, name, or key (required). Use compbox__list_teams to find available teams."),
|
|
11872
|
+
description: z23.string().max(DESCRIPTION_MAX).optional().describe("Epic description"),
|
|
11873
|
+
icon: z23.string().max(50).optional().describe("Icon identifier (e.g., 'rocket', 'star')"),
|
|
11874
|
+
color: z23.string().max(20).optional().describe("Hex color code (e.g., '#FF5733')"),
|
|
11875
|
+
epicRequestId: z23.string().uuid().optional().describe(
|
|
11876
|
+
"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."
|
|
11877
|
+
),
|
|
11878
|
+
bypassGovernance: z23.boolean().optional(),
|
|
11879
|
+
deferConversion: z23.boolean().optional().describe(
|
|
11708
11880
|
"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
11881
|
),
|
|
11710
|
-
features:
|
|
11882
|
+
features: z23.array(compositeFeatureSchema).min(1).describe(
|
|
11711
11883
|
"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
11884
|
)
|
|
11713
11885
|
}
|
|
@@ -11782,8 +11954,10 @@ Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
|
|
|
11782
11954
|
}
|
|
11783
11955
|
if (error.status === 400) {
|
|
11784
11956
|
const body = error.body;
|
|
11957
|
+
const rawError = body && typeof body === "object" ? body.error : void 0;
|
|
11958
|
+
const serverMessage = typeof rawError === "string" ? rawError : typeof rawError?.message === "string" ? rawError.message : void 0;
|
|
11785
11959
|
return createErrorResponse(
|
|
11786
|
-
new Error(`Validation error: ${
|
|
11960
|
+
new Error(`Validation error: ${serverMessage ?? "Invalid input"}`)
|
|
11787
11961
|
);
|
|
11788
11962
|
}
|
|
11789
11963
|
}
|
|
@@ -11803,19 +11977,19 @@ Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
|
|
|
11803
11977
|
{
|
|
11804
11978
|
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
11979
|
inputSchema: {
|
|
11806
|
-
taskId:
|
|
11980
|
+
taskId: z23.string().describe(
|
|
11807
11981
|
"The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
|
|
11808
11982
|
),
|
|
11809
|
-
summary:
|
|
11983
|
+
summary: z23.string().max(5e3).optional().describe(
|
|
11810
11984
|
"Summary of work completed. Will be logged as an AI note when the task is marked complete."
|
|
11811
11985
|
),
|
|
11812
|
-
workingDirectory:
|
|
11986
|
+
workingDirectory: z23.string().max(1e3).optional().describe(
|
|
11813
11987
|
"Working directory for running validation commands. Defaults to current working directory."
|
|
11814
11988
|
),
|
|
11815
|
-
stopOnFirstFailure:
|
|
11989
|
+
stopOnFirstFailure: z23.boolean().optional().describe(
|
|
11816
11990
|
"If true, stops running validations after the first failure. Default is false (run all)."
|
|
11817
11991
|
),
|
|
11818
|
-
skipValidations:
|
|
11992
|
+
skipValidations: z23.boolean().optional().describe(
|
|
11819
11993
|
"If true, skips running validations and completes the task immediately. Use with caution - only for tasks where validations are not applicable."
|
|
11820
11994
|
)
|
|
11821
11995
|
}
|
|
@@ -11928,17 +12102,17 @@ Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
|
|
|
11928
12102
|
}
|
|
11929
12103
|
|
|
11930
12104
|
// src/tools/workflow.ts
|
|
11931
|
-
import { z as
|
|
12105
|
+
import { z as z24 } from "zod";
|
|
11932
12106
|
function registerWorkflowTools(server2) {
|
|
11933
12107
|
server2.registerTool(
|
|
11934
12108
|
"compbox__get_next_required_action",
|
|
11935
12109
|
{
|
|
11936
12110
|
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
12111
|
inputSchema: {
|
|
11938
|
-
itemId:
|
|
12112
|
+
itemId: z24.string().describe(
|
|
11939
12113
|
"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
12114
|
),
|
|
11941
|
-
itemType:
|
|
12115
|
+
itemType: z24.enum(["feature", "task", "epic"]).describe(
|
|
11942
12116
|
"Whether this is a 'feature', 'task', or 'epic'."
|
|
11943
12117
|
)
|
|
11944
12118
|
}
|
|
@@ -12139,7 +12313,7 @@ function registerWorkflowTools(server2) {
|
|
|
12139
12313
|
{
|
|
12140
12314
|
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
12315
|
inputSchema: {
|
|
12142
|
-
sessionId:
|
|
12316
|
+
sessionId: z24.string().describe(
|
|
12143
12317
|
"The session ID to query. Get this from compbox__start_session or compbox__get_active_session."
|
|
12144
12318
|
)
|
|
12145
12319
|
}
|
|
@@ -12169,17 +12343,17 @@ function registerWorkflowTools(server2) {
|
|
|
12169
12343
|
// src/tools/project-flags.ts
|
|
12170
12344
|
import * as fs from "fs/promises";
|
|
12171
12345
|
import * as path from "path";
|
|
12172
|
-
import { z as
|
|
12346
|
+
import { z as z25 } from "zod";
|
|
12173
12347
|
function registerProjectFlagTools(server2) {
|
|
12174
12348
|
server2.registerTool(
|
|
12175
12349
|
"compbox__mark_docs_audit_complete",
|
|
12176
12350
|
{
|
|
12177
12351
|
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:
|
|
12352
|
+
inputSchema: z25.object({
|
|
12353
|
+
projectRoot: z25.string().optional().describe(
|
|
12180
12354
|
"Project root directory (default: current working directory)"
|
|
12181
12355
|
),
|
|
12182
|
-
epicRequestId:
|
|
12356
|
+
epicRequestId: z25.string().optional().describe(
|
|
12183
12357
|
"Optional Epic Request ID if the audit was completed via a CompBox epic request"
|
|
12184
12358
|
)
|
|
12185
12359
|
})
|
|
@@ -12231,7 +12405,7 @@ function registerProjectFlagTools(server2) {
|
|
|
12231
12405
|
}
|
|
12232
12406
|
|
|
12233
12407
|
// src/tools/changelog.ts
|
|
12234
|
-
import { z as
|
|
12408
|
+
import { z as z26 } from "zod";
|
|
12235
12409
|
var entityTypes = ["epic", "feature", "task"];
|
|
12236
12410
|
function registerChangelogTools(server2) {
|
|
12237
12411
|
server2.registerTool(
|
|
@@ -12239,31 +12413,31 @@ function registerChangelogTools(server2) {
|
|
|
12239
12413
|
{
|
|
12240
12414
|
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
12415
|
inputSchema: {
|
|
12242
|
-
entityType:
|
|
12416
|
+
entityType: z26.enum(entityTypes).describe(
|
|
12243
12417
|
"Type of entity to query (required). 'epic' for epic changes, 'feature' for feature changes, 'task' for task changes."
|
|
12244
12418
|
),
|
|
12245
|
-
entityId:
|
|
12419
|
+
entityId: z26.string().describe(
|
|
12246
12420
|
"UUID of the entity to query (required). The specific epic, feature, or task ID."
|
|
12247
12421
|
),
|
|
12248
|
-
epicId:
|
|
12422
|
+
epicId: z26.string().uuid().optional().describe(
|
|
12249
12423
|
"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
12424
|
),
|
|
12251
|
-
field:
|
|
12425
|
+
field: z26.string().max(255).optional().describe(
|
|
12252
12426
|
"Filter by specific field name (optional). Examples: 'statusId', 'title', 'assigneeId', 'description'. Only changes to this field will be returned."
|
|
12253
12427
|
),
|
|
12254
|
-
changedBy:
|
|
12428
|
+
changedBy: z26.string().uuid().optional().describe(
|
|
12255
12429
|
"Filter by user ID who made the change (optional). Only returns changes made by this user."
|
|
12256
12430
|
),
|
|
12257
|
-
since:
|
|
12431
|
+
since: z26.string().optional().describe(
|
|
12258
12432
|
"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
12433
|
),
|
|
12260
|
-
until:
|
|
12434
|
+
until: z26.string().optional().describe(
|
|
12261
12435
|
"Filter changes before this date (optional). Accepts ISO-8601 date format."
|
|
12262
12436
|
),
|
|
12263
|
-
limit:
|
|
12437
|
+
limit: z26.number().int().min(1).max(100).optional().describe(
|
|
12264
12438
|
"Maximum number of entries to return (default: 20, max: 100)."
|
|
12265
12439
|
),
|
|
12266
|
-
cursor:
|
|
12440
|
+
cursor: z26.string().optional().describe(
|
|
12267
12441
|
"Pagination cursor from a previous response. Pass this to fetch the next page of results."
|
|
12268
12442
|
)
|
|
12269
12443
|
}
|
|
@@ -12316,7 +12490,7 @@ function registerChangelogTools(server2) {
|
|
|
12316
12490
|
}
|
|
12317
12491
|
|
|
12318
12492
|
// src/tools/sessions.ts
|
|
12319
|
-
import { z as
|
|
12493
|
+
import { z as z27 } from "zod";
|
|
12320
12494
|
import * as fs2 from "fs";
|
|
12321
12495
|
import * as path2 from "path";
|
|
12322
12496
|
function readLocalManifest() {
|
|
@@ -12377,13 +12551,13 @@ function registerSessionTools(server2) {
|
|
|
12377
12551
|
{
|
|
12378
12552
|
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
12553
|
inputSchema: {
|
|
12380
|
-
epicId:
|
|
12554
|
+
epicId: z27.string().describe(
|
|
12381
12555
|
"The epic to start a session for. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
|
|
12382
12556
|
),
|
|
12383
|
-
externalId:
|
|
12557
|
+
externalId: z27.string().optional().describe(
|
|
12384
12558
|
"Optional external session identifier (e.g., from Copilot or another AI tool)."
|
|
12385
12559
|
),
|
|
12386
|
-
featureId:
|
|
12560
|
+
featureId: z27.string().uuid().optional().describe(
|
|
12387
12561
|
"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
12562
|
)
|
|
12389
12563
|
}
|
|
@@ -12411,19 +12585,19 @@ function registerSessionTools(server2) {
|
|
|
12411
12585
|
{
|
|
12412
12586
|
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
12587
|
inputSchema: {
|
|
12414
|
-
epicId:
|
|
12588
|
+
epicId: z27.string().describe(
|
|
12415
12589
|
"The epic whose active session to end. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
|
|
12416
12590
|
),
|
|
12417
|
-
summary:
|
|
12418
|
-
nextSteps:
|
|
12419
|
-
blockers:
|
|
12420
|
-
decisions:
|
|
12421
|
-
|
|
12422
|
-
decision:
|
|
12423
|
-
rationale:
|
|
12591
|
+
summary: z27.string().describe("Summary of work completed during this session."),
|
|
12592
|
+
nextSteps: z27.array(z27.string()).optional().describe("Recommended next actions for the successor session."),
|
|
12593
|
+
blockers: z27.array(z27.string()).optional().describe("Blockers encountered during this session."),
|
|
12594
|
+
decisions: z27.array(
|
|
12595
|
+
z27.object({
|
|
12596
|
+
decision: z27.string(),
|
|
12597
|
+
rationale: z27.string().optional()
|
|
12424
12598
|
})
|
|
12425
12599
|
).optional().describe("Key decisions made during this session with rationale."),
|
|
12426
|
-
contextBlob:
|
|
12600
|
+
contextBlob: z27.string().optional().describe("Optional free-form context blob for the next session.")
|
|
12427
12601
|
}
|
|
12428
12602
|
},
|
|
12429
12603
|
async (input) => {
|
|
@@ -12447,7 +12621,7 @@ function registerSessionTools(server2) {
|
|
|
12447
12621
|
{
|
|
12448
12622
|
description: "Check if there is an active AI session for an epic. Returns the session if active, or null.",
|
|
12449
12623
|
inputSchema: {
|
|
12450
|
-
epicId:
|
|
12624
|
+
epicId: z27.string().describe(
|
|
12451
12625
|
"The epic to check. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
|
|
12452
12626
|
)
|
|
12453
12627
|
}
|
|
@@ -12467,7 +12641,7 @@ function registerSessionTools(server2) {
|
|
|
12467
12641
|
{
|
|
12468
12642
|
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
12643
|
inputSchema: {
|
|
12470
|
-
epicId:
|
|
12644
|
+
epicId: z27.string().describe(
|
|
12471
12645
|
"The epic to query. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
|
|
12472
12646
|
)
|
|
12473
12647
|
}
|
|
@@ -12487,10 +12661,10 @@ function registerSessionTools(server2) {
|
|
|
12487
12661
|
{
|
|
12488
12662
|
description: "Get the history of AI sessions for an epic. Returns past sessions ordered by most recent first.",
|
|
12489
12663
|
inputSchema: {
|
|
12490
|
-
epicId:
|
|
12664
|
+
epicId: z27.string().describe(
|
|
12491
12665
|
"The epic to query. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
|
|
12492
12666
|
),
|
|
12493
|
-
limit:
|
|
12667
|
+
limit: z27.number().int().min(1).max(100).optional().describe("Maximum number of sessions to return (default: 10, max: 100).")
|
|
12494
12668
|
}
|
|
12495
12669
|
},
|
|
12496
12670
|
async (input) => {
|
|
@@ -12509,7 +12683,7 @@ function registerSessionTools(server2) {
|
|
|
12509
12683
|
}
|
|
12510
12684
|
|
|
12511
12685
|
// src/tools/compliance.ts
|
|
12512
|
-
import { z as
|
|
12686
|
+
import { z as z28 } from "zod";
|
|
12513
12687
|
var TIER_EMOJI = {
|
|
12514
12688
|
pass: "\u2705",
|
|
12515
12689
|
advisory: "\u26A0\uFE0F",
|
|
@@ -12580,7 +12754,7 @@ function registerComplianceTools(server2) {
|
|
|
12580
12754
|
{
|
|
12581
12755
|
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
12756
|
inputSchema: {
|
|
12583
|
-
id:
|
|
12757
|
+
id: z28.string().min(1).describe(
|
|
12584
12758
|
"The epic request to audit. Accepts UUID or identifier (e.g., 'ER-1')."
|
|
12585
12759
|
)
|
|
12586
12760
|
}
|
|
@@ -12602,7 +12776,7 @@ function registerComplianceTools(server2) {
|
|
|
12602
12776
|
{
|
|
12603
12777
|
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
12778
|
inputSchema: {
|
|
12605
|
-
id:
|
|
12779
|
+
id: z28.string().min(1).describe(
|
|
12606
12780
|
"The epic to audit. Accepts UUID, identifier (e.g., 'ENG-E1'), or exact name."
|
|
12607
12781
|
)
|
|
12608
12782
|
}
|
|
@@ -12639,20 +12813,20 @@ function registerComplianceTools(server2) {
|
|
|
12639
12813
|
}
|
|
12640
12814
|
|
|
12641
12815
|
// src/tools/skill-packs/manage.ts
|
|
12642
|
-
import { z as
|
|
12816
|
+
import { z as z31 } from "zod";
|
|
12643
12817
|
|
|
12644
12818
|
// src/tools/skill-packs/get-manifest.ts
|
|
12645
|
-
import { z as
|
|
12819
|
+
import { z as z29 } from "zod";
|
|
12646
12820
|
function registerGetPackManifestTool(server2) {
|
|
12647
12821
|
server2.registerTool(
|
|
12648
12822
|
"compbox__get_pack_manifest",
|
|
12649
12823
|
{
|
|
12650
12824
|
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
12825
|
inputSchema: {
|
|
12652
|
-
id:
|
|
12826
|
+
id: z29.string().describe(
|
|
12653
12827
|
"Skill pack ID or name (e.g., '@mycompbox/planning' or UUID)"
|
|
12654
12828
|
),
|
|
12655
|
-
version:
|
|
12829
|
+
version: z29.string().optional().describe(
|
|
12656
12830
|
"Specific version to get manifest for (e.g., '1.2.3'). If not provided, uses latest stable version."
|
|
12657
12831
|
)
|
|
12658
12832
|
}
|
|
@@ -12742,7 +12916,7 @@ function registerGetPackManifestTool(server2) {
|
|
|
12742
12916
|
}
|
|
12743
12917
|
|
|
12744
12918
|
// src/tools/skill-packs/sync-local.ts
|
|
12745
|
-
import { z as
|
|
12919
|
+
import { z as z30 } from "zod";
|
|
12746
12920
|
import * as fs3 from "fs/promises";
|
|
12747
12921
|
import * as path3 from "path";
|
|
12748
12922
|
import { existsSync } from "fs";
|
|
@@ -12752,7 +12926,7 @@ function registerSyncLocalPacksTool(server2) {
|
|
|
12752
12926
|
{
|
|
12753
12927
|
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
12928
|
inputSchema: {
|
|
12755
|
-
projectRoot:
|
|
12929
|
+
projectRoot: z30.string().optional().describe(
|
|
12756
12930
|
"Project root directory (default: current working directory). Must contain .compbox/ and .github/ directories."
|
|
12757
12931
|
)
|
|
12758
12932
|
}
|
|
@@ -12944,21 +13118,21 @@ function registerSkillPackTools(server2) {
|
|
|
12944
13118
|
"compbox__manage_skill_packs",
|
|
12945
13119
|
{
|
|
12946
13120
|
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:
|
|
13121
|
+
inputSchema: z31.object({
|
|
13122
|
+
action: z31.enum(["list", "get", "install", "update", "list_installed"]).describe(
|
|
12949
13123
|
"The action to perform: 'list' (browse registry), 'get' (pack details), 'install', 'update', or 'list_installed' (your installed packs)"
|
|
12950
13124
|
),
|
|
12951
13125
|
// Used by: list, get, install, update
|
|
12952
|
-
id:
|
|
13126
|
+
id: z31.string().optional().describe("Skill pack ID or name (e.g., '@mycompbox/planning'). Required for get/install/update actions."),
|
|
12953
13127
|
// Used by: list
|
|
12954
|
-
cursor:
|
|
12955
|
-
limit:
|
|
12956
|
-
isOfficial:
|
|
12957
|
-
query:
|
|
13128
|
+
cursor: z31.string().optional().describe("Pagination cursor from previous response (list action only)"),
|
|
13129
|
+
limit: z31.number().int().min(1).max(100).optional().describe("Maximum results per page, default 20, max 100 (list action only)"),
|
|
13130
|
+
isOfficial: z31.boolean().optional().describe("Filter by official packs (list action only)"),
|
|
13131
|
+
query: z31.string().optional().describe("Search query to filter by name (list action only)"),
|
|
12958
13132
|
// Used by: get
|
|
12959
|
-
includeVersions:
|
|
13133
|
+
includeVersions: z31.boolean().optional().describe("Include all versions in response (get action only)"),
|
|
12960
13134
|
// Used by: install, update
|
|
12961
|
-
version:
|
|
13135
|
+
version: z31.string().optional().describe("Version to install/update to (e.g., '1.2.3' or 'latest'). Required for install/update actions.")
|
|
12962
13136
|
})
|
|
12963
13137
|
},
|
|
12964
13138
|
async (input) => {
|
|
@@ -13244,7 +13418,7 @@ function withLegacyToolCallRewrite(transport) {
|
|
|
13244
13418
|
var SERVER_NAME = "compbox-mcp";
|
|
13245
13419
|
function resolveServerVersion() {
|
|
13246
13420
|
if (true) {
|
|
13247
|
-
return "1.21.
|
|
13421
|
+
return "1.21.14";
|
|
13248
13422
|
}
|
|
13249
13423
|
const require2 = createRequire(import.meta.url);
|
|
13250
13424
|
for (const candidate of ["../package.json", "./package.json"]) {
|