test(FN-1281): expand mission and subtask test coverage

- Extend mission API e2e coverage across CRUD, validation edge cases, observability, interview flows, and autopilot endpoints
- Add regression tests for generated mission/milestone/slice/feature ID handling across route validation paths
- Add subtask-breakdown unit tests for stream manager behavior, JSON parsing/normalization, fallback generation, and error handling
- Cover subtask session lifecycle and SQLite rehydration behavior, including corrupted-row resilience and in-memory fallback precedence
This commit is contained in:
gsxdsm
2026-04-08 10:40:21 -07:00
parent 29255a4a6a
commit dfb8a877d0
2 changed files with 1148 additions and 67 deletions

View File

@@ -148,12 +148,20 @@ function createMockMissionStore() {
return updated;
}),
updateMissionInterviewState: vi.fn((id: string, state: Mission["interviewState"]) => {
const mission = missions.get(id);
if (!mission) throw new Error("Mission " + id + " not found");
const updated = { ...mission, interviewState: state, updatedAt: new Date().toISOString() };
missions.set(id, updated);
return updated;
}),
deleteMission: vi.fn((id: string) => {
if (!missions.has(id)) throw new Error("Mission " + id + " not found");
missions.delete(id);
}),
addMilestone: vi.fn((missionId: string, input: { title: string; description?: string }) => {
addMilestone: vi.fn((missionId: string, input: { title: string; description?: string; dependencies?: string[] }) => {
const milestone: Milestone = {
id: generateMilestoneId(),
missionId,
@@ -162,7 +170,7 @@ function createMockMissionStore() {
status: "planning",
orderIndex: Array.from(milestones.values()).filter((m) => m.missionId === missionId).length,
interviewState: "not_started",
dependencies: [],
dependencies: input.dependencies ?? [],
createdAt: new Date().toISOString(),
updatedAt: new Date().toISOString(),
};
@@ -178,6 +186,37 @@ function createMockMissionStore() {
.sort((a, b) => a.orderIndex - b.orderIndex)
),
updateMilestone: vi.fn((id: string, updates: Partial<Milestone>) => {
const milestone = milestones.get(id);
if (!milestone) throw new Error("Milestone " + id + " not found");
const updated = { ...milestone, ...updates, updatedAt: new Date().toISOString() };
milestones.set(id, updated);
return updated;
}),
updateMilestoneInterviewState: vi.fn((id: string, state: Milestone["interviewState"]) => {
const milestone = milestones.get(id);
if (!milestone) throw new Error("Milestone " + id + " not found");
const updated = { ...milestone, interviewState: state, updatedAt: new Date().toISOString() };
milestones.set(id, updated);
return updated;
}),
deleteMilestone: vi.fn((id: string) => {
if (!milestones.has(id)) throw new Error("Milestone " + id + " not found");
milestones.delete(id);
for (const slice of Array.from(slices.values())) {
if (slice.milestoneId === id) {
slices.delete(slice.id);
for (const feature of Array.from(features.values())) {
if (feature.sliceId === slice.id) {
features.delete(feature.id);
}
}
}
}
}),
addSlice: vi.fn((milestoneId: string, input: { title: string; description?: string }) => {
const slice: Slice = {
id: generateSliceId(),
@@ -209,12 +248,23 @@ function createMockMissionStore() {
return updated;
}),
addFeature: vi.fn((sliceId: string, input: { title: string; description?: string }) => {
deleteSlice: vi.fn((id: string) => {
if (!slices.has(id)) throw new Error("Slice " + id + " not found");
slices.delete(id);
for (const feature of Array.from(features.values())) {
if (feature.sliceId === id) {
features.delete(feature.id);
}
}
}),
addFeature: vi.fn((sliceId: string, input: { title: string; description?: string; acceptanceCriteria?: string }) => {
const feature: MissionFeature = {
id: generateFeatureId(),
sliceId,
title: input.title,
description: input.description,
acceptanceCriteria: input.acceptanceCriteria,
status: "defined",
createdAt: new Date().toISOString(),
updatedAt: new Date().toISOString(),
@@ -225,6 +275,10 @@ function createMockMissionStore() {
getFeature: vi.fn((id: string) => features.get(id)),
listFeatures: vi.fn((sliceId: string) =>
Array.from(features.values()).filter((feature) => feature.sliceId === sliceId)
),
activateSlice: vi.fn((id: string) => {
const slice = slices.get(id);
if (!slice) throw new Error("Slice " + id + " not found");
@@ -284,8 +338,32 @@ function createMockMissionStore() {
return updated;
}),
reorderMilestones: vi.fn(),
reorderSlices: vi.fn(),
reorderMilestones: vi.fn((missionId: string, orderedIds: string[]) => {
orderedIds.forEach((id, index) => {
const milestone = milestones.get(id);
if (!milestone || milestone.missionId !== missionId) {
throw new Error("Milestone " + id + " not found");
}
milestones.set(id, {
...milestone,
orderIndex: index,
updatedAt: new Date().toISOString(),
});
});
}),
reorderSlices: vi.fn((milestoneId: string, orderedIds: string[]) => {
orderedIds.forEach((id, index) => {
const slice = slices.get(id);
if (!slice || slice.milestoneId !== milestoneId) {
throw new Error("Slice " + id + " not found");
}
slices.set(id, {
...slice,
orderIndex: index,
updatedAt: new Date().toISOString(),
});
});
}),
// Triage methods
triageFeature: vi.fn(async (featureId: string) => {
@@ -360,11 +438,21 @@ function createMockMissionAutopilot() {
};
}
function buildApp(options?: { missionAutopilot?: ReturnType<typeof createMockMissionAutopilot> }) {
function buildApp(options?: {
missionAutopilot?: ReturnType<typeof createMockMissionAutopilot>;
withErrorHandler?: boolean;
}) {
const app = express();
app.use(express.json());
const store = createMockStore();
app.use("/api/missions", createMissionRouter(store, options?.missionAutopilot));
if (options?.withErrorHandler) {
app.use((err: Error, _req: express.Request, res: express.Response, _next: express.NextFunction) => {
res.status(500).json({ error: err.message });
});
}
return { app, store, missionStore: store.getMissionStore() };
}
@@ -875,8 +963,713 @@ describe("Mission API", () => {
});
});
describe("Interview endpoints", () => {
beforeEach(() => {
describe("Milestone CRUD", () => {
it("GET /api/missions/:missionId/milestones returns sorted milestones and 404 for missing mission", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const first = missionStore.addMilestone(mission.id, { title: "First" });
const second = missionStore.addMilestone(mission.id, { title: "Second" });
missionStore.updateMilestone(first.id, { orderIndex: 1 });
missionStore.updateMilestone(second.id, { orderIndex: 0 });
const ok = await get(app, `/api/missions/${mission.id}/milestones`);
expect(ok.status).toBe(200);
expect(ok.body.map((milestone: Milestone) => milestone.id)).toEqual([second.id, first.id]);
const missing = await get(app, "/api/missions/M-NOT-FOUND/milestones");
expect(missing.status).toBe(404);
});
it("POST /api/missions/:missionId/milestones creates milestones and validates payload", async () => {
const { app, missionStore } = buildApp({ withErrorHandler: true });
const mission = missionStore.createMission({ title: "Mission" });
const created = await request(
app,
"POST",
`/api/missions/${mission.id}/milestones`,
JSON.stringify({
title: "Milestone A",
description: "Detailed milestone",
dependencies: ["MS-UPSTREAM-1"],
}),
{ "content-type": "application/json" },
);
expect(created.status).toBe(201);
expect(created.body.title).toBe("Milestone A");
expect(created.body.description).toBe("Detailed milestone");
expect(created.body.dependencies).toEqual(["MS-UPSTREAM-1"]);
const missingMission = await request(
app,
"POST",
"/api/missions/M-NOT-FOUND/milestones",
JSON.stringify({ title: "Milestone" }),
{ "content-type": "application/json" },
);
expect(missingMission.status).toBe(404);
const missingTitle = await request(
app,
"POST",
`/api/missions/${mission.id}/milestones`,
JSON.stringify({ description: "No title" }),
{ "content-type": "application/json" },
);
expect(missingTitle.status).toBe(500);
expect(missingTitle.body.error).toContain("Title is required");
const tooLongTitle = await request(
app,
"POST",
`/api/missions/${mission.id}/milestones`,
JSON.stringify({ title: "x".repeat(201) }),
{ "content-type": "application/json" },
);
expect(tooLongTitle.status).toBe(500);
expect(tooLongTitle.body.error).toContain("Title must not exceed 200 characters");
});
it("PATCH /api/missions/milestones/:milestoneId updates individual fields", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Original" });
const updateTitle = await request(
app,
"PATCH",
`/api/missions/milestones/${milestone.id}`,
JSON.stringify({ title: "Renamed" }),
{ "content-type": "application/json" },
);
expect(updateTitle.status).toBe(200);
expect(updateTitle.body.title).toBe("Renamed");
const updateStatus = await request(
app,
"PATCH",
`/api/missions/milestones/${milestone.id}`,
JSON.stringify({ status: "active" }),
{ "content-type": "application/json" },
);
expect(updateStatus.status).toBe(200);
expect(updateStatus.body.status).toBe("active");
const updateDescription = await request(
app,
"PATCH",
`/api/missions/milestones/${milestone.id}`,
JSON.stringify({ description: "Updated description" }),
{ "content-type": "application/json" },
);
expect(updateDescription.status).toBe(200);
expect(updateDescription.body.description).toBe("Updated description");
const updateDependencies = await request(
app,
"PATCH",
`/api/missions/milestones/${milestone.id}`,
JSON.stringify({ dependencies: ["MS-DEP-1"] }),
{ "content-type": "application/json" },
);
expect(updateDependencies.status).toBe(200);
expect(updateDependencies.body.dependencies).toEqual(["MS-DEP-1"]);
const noFields = await request(
app,
"PATCH",
`/api/missions/milestones/${milestone.id}`,
JSON.stringify({}),
{ "content-type": "application/json" },
);
expect(noFields.status).toBe(400);
expect(noFields.body.error).toContain("No valid fields to update");
const missingMilestone = await request(
app,
"PATCH",
"/api/missions/milestones/MS-NOT-FOUND",
JSON.stringify({ title: "Nope" }),
{ "content-type": "application/json" },
);
expect(missingMilestone.status).toBe(404);
});
it("DELETE /api/missions/milestones/:milestoneId validates ID and existence", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "To Delete" });
const removed = await request(app, "DELETE", `/api/missions/milestones/${milestone.id}`);
expect(removed.status).toBe(204);
const missing = await request(app, "DELETE", "/api/missions/milestones/MS-NOT-FOUND");
expect(missing.status).toBe(404);
const invalid = await request(app, "DELETE", "/api/missions/milestones/bad-id");
expect(invalid.status).toBe(400);
expect(invalid.body.error).toContain("Invalid milestone ID format");
});
it("POST /api/missions/:missionId/milestones/reorder enforces complete ordered IDs", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const m1 = missionStore.addMilestone(mission.id, { title: "One" });
const m2 = missionStore.addMilestone(mission.id, { title: "Two" });
const ok = await request(
app,
"POST",
`/api/missions/${mission.id}/milestones/reorder`,
JSON.stringify({ orderedIds: [m2.id, m1.id] }),
{ "content-type": "application/json" },
);
expect(ok.status).toBe(204);
expect(missionStore.reorderMilestones).toHaveBeenCalledWith(mission.id, [m2.id, m1.id]);
const incomplete = await request(
app,
"POST",
`/api/missions/${mission.id}/milestones/reorder`,
JSON.stringify({ orderedIds: [m1.id] }),
{ "content-type": "application/json" },
);
expect(incomplete.status).toBe(400);
expect(incomplete.body.error).toContain("orderedIds must include all milestones");
const wrongMissionIds = await request(
app,
"POST",
`/api/missions/${mission.id}/milestones/reorder`,
JSON.stringify({ orderedIds: [m1.id, "MS-OTHER-MISSION"] }),
{ "content-type": "application/json" },
);
expect(wrongMissionIds.status).toBe(400);
expect(wrongMissionIds.body.error).toContain("Invalid milestone IDs in orderedIds");
});
});
describe("Slice CRUD", () => {
it("GET /api/missions/milestones/:milestoneId/slices returns sorted slices and 404 for missing milestone", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const first = missionStore.addSlice(milestone.id, { title: "First" });
const second = missionStore.addSlice(milestone.id, { title: "Second" });
missionStore.updateSlice(first.id, { orderIndex: 2 });
missionStore.updateSlice(second.id, { orderIndex: 0 });
const ok = await get(app, `/api/missions/milestones/${milestone.id}/slices`);
expect(ok.status).toBe(200);
expect(ok.body.map((slice: Slice) => slice.id)).toEqual([second.id, first.id]);
const missing = await get(app, "/api/missions/milestones/MS-NOT-FOUND/slices");
expect(missing.status).toBe(404);
});
it("POST /api/missions/milestones/:milestoneId/slices handles success, 404, and missing title", async () => {
const { app, missionStore } = buildApp({ withErrorHandler: true });
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const created = await request(
app,
"POST",
`/api/missions/milestones/${milestone.id}/slices`,
JSON.stringify({ title: "Slice A", description: "Slice details" }),
{ "content-type": "application/json" },
);
expect(created.status).toBe(201);
expect(created.body.title).toBe("Slice A");
const missingMilestone = await request(
app,
"POST",
"/api/missions/milestones/MS-NOT-FOUND/slices",
JSON.stringify({ title: "Slice" }),
{ "content-type": "application/json" },
);
expect(missingMilestone.status).toBe(404);
const missingTitle = await request(
app,
"POST",
`/api/missions/milestones/${milestone.id}/slices`,
JSON.stringify({ description: "No title" }),
{ "content-type": "application/json" },
);
expect(missingTitle.status).toBe(500);
expect(missingTitle.body.error).toContain("Title is required");
});
it("PATCH /api/missions/slices/:sliceId updates individual fields and validates empty body", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "Original" });
const titleUpdate = await request(
app,
"PATCH",
`/api/missions/slices/${slice.id}`,
JSON.stringify({ title: "Renamed" }),
{ "content-type": "application/json" },
);
expect(titleUpdate.status).toBe(200);
expect(titleUpdate.body.title).toBe("Renamed");
const descriptionUpdate = await request(
app,
"PATCH",
`/api/missions/slices/${slice.id}`,
JSON.stringify({ description: "Updated description" }),
{ "content-type": "application/json" },
);
expect(descriptionUpdate.status).toBe(200);
expect(descriptionUpdate.body.description).toBe("Updated description");
const statusUpdate = await request(
app,
"PATCH",
`/api/missions/slices/${slice.id}`,
JSON.stringify({ status: "active" }),
{ "content-type": "application/json" },
);
expect(statusUpdate.status).toBe(200);
expect(statusUpdate.body.status).toBe("active");
const empty = await request(
app,
"PATCH",
`/api/missions/slices/${slice.id}`,
JSON.stringify({}),
{ "content-type": "application/json" },
);
expect(empty.status).toBe(400);
expect(empty.body.error).toContain("No valid fields to update");
});
it("DELETE /api/missions/slices/:sliceId validates ID and existence", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "To Delete" });
const removed = await request(app, "DELETE", `/api/missions/slices/${slice.id}`);
expect(removed.status).toBe(204);
const missing = await request(app, "DELETE", "/api/missions/slices/SL-NOT-FOUND");
expect(missing.status).toBe(404);
const invalid = await request(app, "DELETE", "/api/missions/slices/bad-id");
expect(invalid.status).toBe(400);
expect(invalid.body.error).toContain("Invalid slice ID format");
});
it("POST /api/missions/milestones/:milestoneId/slices/reorder validates IDs", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const s1 = missionStore.addSlice(milestone.id, { title: "One" });
const s2 = missionStore.addSlice(milestone.id, { title: "Two" });
const ok = await request(
app,
"POST",
`/api/missions/milestones/${milestone.id}/slices/reorder`,
JSON.stringify({ orderedIds: [s2.id, s1.id] }),
{ "content-type": "application/json" },
);
expect(ok.status).toBe(204);
expect(missionStore.reorderSlices).toHaveBeenCalledWith(milestone.id, [s2.id, s1.id]);
const incomplete = await request(
app,
"POST",
`/api/missions/milestones/${milestone.id}/slices/reorder`,
JSON.stringify({ orderedIds: [s1.id] }),
{ "content-type": "application/json" },
);
expect(incomplete.status).toBe(400);
expect(incomplete.body.error).toContain("orderedIds must include all slices");
const invalidIds = await request(
app,
"POST",
`/api/missions/milestones/${milestone.id}/slices/reorder`,
JSON.stringify({ orderedIds: [s1.id, "SL-OTHER-MILESTONE"] }),
{ "content-type": "application/json" },
);
expect(invalidIds.status).toBe(400);
expect(invalidIds.body.error).toContain("Invalid slice IDs in orderedIds");
});
});
describe("Feature CRUD detail", () => {
it("GET /api/missions/slices/:sliceId/features returns features and 404 for missing slice", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "Slice" });
const feature = missionStore.addFeature(slice.id, { title: "Feature A" });
const ok = await get(app, `/api/missions/slices/${slice.id}/features`);
expect(ok.status).toBe(200);
expect(ok.body).toHaveLength(1);
expect(ok.body[0].id).toBe(feature.id);
const missing = await get(app, "/api/missions/slices/SL-NOT-FOUND/features");
expect(missing.status).toBe(404);
});
it("POST /api/missions/slices/:sliceId/features supports acceptanceCriteria and missing slice", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "Slice" });
const created = await request(
app,
"POST",
`/api/missions/slices/${slice.id}/features`,
JSON.stringify({
title: "Feature A",
description: "Feature details",
acceptanceCriteria: "All tests pass",
}),
{ "content-type": "application/json" },
);
expect(created.status).toBe(201);
expect(created.body.acceptanceCriteria).toBe("All tests pass");
const missingSlice = await request(
app,
"POST",
"/api/missions/slices/SL-NOT-FOUND/features",
JSON.stringify({ title: "Feature" }),
{ "content-type": "application/json" },
);
expect(missingSlice.status).toBe(404);
});
it("PATCH /api/missions/features/:featureId updates acceptanceCriteria", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "Slice" });
const feature = missionStore.addFeature(slice.id, { title: "Feature" });
const res = await request(
app,
"PATCH",
`/api/missions/features/${feature.id}`,
JSON.stringify({ acceptanceCriteria: "Updated criteria" }),
{ "content-type": "application/json" },
);
expect(res.status).toBe(200);
expect(res.body.acceptanceCriteria).toBe("Updated criteria");
expect(missionStore.updateFeature).toHaveBeenCalledWith(feature.id, {
acceptanceCriteria: "Updated criteria",
});
});
it("DELETE /api/missions/features/:featureId succeeds and rejects invalid ID format", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "Slice" });
const feature = missionStore.addFeature(slice.id, { title: "Feature" });
const removed = await request(app, "DELETE", `/api/missions/features/${feature.id}`);
expect(removed.status).toBe(204);
const invalid = await request(app, "DELETE", "/api/missions/features/invalid-id");
expect(invalid.status).toBe(400);
expect(invalid.body.error).toContain("Invalid feature ID format");
});
it("POST /api/missions/features/:featureId/unlink-task handles linked and unlinked features", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "Slice" });
const linkedFeature = missionStore.addFeature(slice.id, { title: "Linked Feature" });
missionStore.linkFeatureToTask(linkedFeature.id, "FN-001");
const unlinked = await request(
app,
"POST",
`/api/missions/features/${linkedFeature.id}/unlink-task`,
JSON.stringify({}),
{ "content-type": "application/json" },
);
expect(unlinked.status).toBe(200);
expect(unlinked.body.taskId).toBeUndefined();
const plainFeature = missionStore.addFeature(slice.id, { title: "No Task Feature" });
const error = await request(
app,
"POST",
`/api/missions/features/${plainFeature.id}/unlink-task`,
JSON.stringify({}),
{ "content-type": "application/json" },
);
expect(error.status).toBe(400);
expect(error.body).toEqual({ error: "Feature is not linked to a task" });
});
it("POST /api/missions/features/:featureId/link-task validates taskId and returns 409 for already linked", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const slice = missionStore.addSlice(milestone.id, { title: "Slice" });
const feature = missionStore.addFeature(slice.id, { title: "Feature" });
const missingTaskId = await request(
app,
"POST",
`/api/missions/features/${feature.id}/link-task`,
JSON.stringify({}),
{ "content-type": "application/json" },
);
expect(missingTaskId.status).toBe(400);
const nonStringTaskId = await request(
app,
"POST",
`/api/missions/features/${feature.id}/link-task`,
JSON.stringify({ taskId: 42 }),
{ "content-type": "application/json" },
);
expect(nonStringTaskId.status).toBe(400);
(missionStore.linkFeatureToTask as ReturnType<typeof vi.fn>).mockImplementationOnce(() => {
throw new Error("Feature is already linked to a task");
});
const conflict = await request(
app,
"POST",
`/api/missions/features/${feature.id}/link-task`,
JSON.stringify({ taskId: "FN-123" }),
{ "content-type": "application/json" },
);
expect(conflict.status).toBe(409);
expect(conflict.body.error).toContain("already linked");
});
});
describe("Interview state endpoints", () => {
it("GET /api/missions/:missionId/interview-state returns default state and validates ids", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const ok = await get(app, `/api/missions/${mission.id}/interview-state`);
expect(ok.status).toBe(200);
expect(ok.body).toEqual({ state: "not_started" });
const missing = await get(app, "/api/missions/M-NOT-FOUND/interview-state");
expect(missing.status).toBe(404);
const invalid = await get(app, "/api/missions/invalid-id/interview-state");
expect(invalid.status).toBe(400);
expect(invalid.body.error).toContain("Invalid mission ID format");
});
it("POST /api/missions/:missionId/interview-state updates mission interview state", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const updated = await request(
app,
"POST",
`/api/missions/${mission.id}/interview-state`,
JSON.stringify({ state: "in_progress" }),
{ "content-type": "application/json" },
);
expect(updated.status).toBe(200);
expect(updated.body.interviewState).toBe("in_progress");
expect(missionStore.updateMissionInterviewState).toHaveBeenCalledWith(mission.id, "in_progress");
expect(missionStore.getMission(mission.id)?.interviewState).toBe("in_progress");
const missing = await request(
app,
"POST",
"/api/missions/M-NOT-FOUND/interview-state",
JSON.stringify({ state: "in_progress" }),
{ "content-type": "application/json" },
);
expect(missing.status).toBe(404);
});
it("POST /api/missions/:missionId/interview-state rejects invalid interview state values", async () => {
const { app, missionStore } = buildApp({ withErrorHandler: true });
const mission = missionStore.createMission({ title: "Mission" });
const invalid = await request(
app,
"POST",
`/api/missions/${mission.id}/interview-state`,
JSON.stringify({ state: "bogus" }),
{ "content-type": "application/json" },
);
expect(invalid.status).toBe(500);
expect(invalid.body.error).toContain("Invalid interview state");
});
it("GET/POST milestone interview-state endpoints read and update milestone state", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const getState = await get(app, `/api/missions/milestones/${milestone.id}/interview-state`);
expect(getState.status).toBe(200);
expect(getState.body).toEqual({ state: "not_started" });
const setState = await request(
app,
"POST",
`/api/missions/milestones/${milestone.id}/interview-state`,
JSON.stringify({ state: "completed" }),
{ "content-type": "application/json" },
);
expect(setState.status).toBe(200);
expect(setState.body.interviewState).toBe("completed");
expect(missionStore.updateMilestoneInterviewState).toHaveBeenCalledWith(milestone.id, "completed");
const missingGet = await get(app, "/api/missions/milestones/MS-NOT-FOUND/interview-state");
expect(missingGet.status).toBe(404);
const missingPost = await request(
app,
"POST",
"/api/missions/milestones/MS-NOT-FOUND/interview-state",
JSON.stringify({ state: "completed" }),
{ "content-type": "application/json" },
);
expect(missingPost.status).toBe(404);
});
it("POST milestone interview-state rejects invalid values", async () => {
const { app, missionStore } = buildApp({ withErrorHandler: true });
const mission = missionStore.createMission({ title: "Mission" });
const milestone = missionStore.addMilestone(mission.id, { title: "Milestone" });
const invalid = await request(
app,
"POST",
`/api/missions/milestones/${milestone.id}/interview-state`,
JSON.stringify({ state: "bad" }),
{ "content-type": "application/json" },
);
expect(invalid.status).toBe(500);
expect(invalid.body.error).toContain("Invalid interview state");
});
});
describe("Mission status endpoint", () => {
it("GET /api/missions/:missionId/status returns computed status and validates errors", async () => {
const { app, missionStore } = buildApp();
const mission = missionStore.createMission({ title: "Mission" });
const ok = await get(app, `/api/missions/${mission.id}/status`);
expect(ok.status).toBe(200);
expect(ok.body).toEqual({ status: "active" });
expect(missionStore.computeMissionStatus).toHaveBeenCalledWith(mission.id);
const missing = await get(app, "/api/missions/M-NOT-FOUND/status");
expect(missing.status).toBe(404);
const invalid = await get(app, "/api/missions/invalid-id/status");
expect(invalid.status).toBe(400);
expect(invalid.body.error).toContain("Invalid mission ID format");
});
});
describe("Validation edge cases", () => {
it("mission creation validates empty title, whitespace title, and oversized description", async () => {
const { app } = buildApp({ withErrorHandler: true });
const emptyTitle = await request(
app,
"POST",
"/api/missions",
JSON.stringify({ title: "" }),
{ "content-type": "application/json" },
);
expect(emptyTitle.status).toBe(500);
expect(emptyTitle.body.error).toContain("Title is required");
const whitespaceTitle = await request(
app,
"POST",
"/api/missions",
JSON.stringify({ title: " " }),
{ "content-type": "application/json" },
);
expect(whitespaceTitle.status).toBe(500);
expect(whitespaceTitle.body.error).toContain("Title is required");
const oversizedDescription = await request(
app,
"POST",
"/api/missions",
JSON.stringify({ title: "Valid title", description: "x".repeat(5001) }),
{ "content-type": "application/json" },
);
expect(oversizedDescription.status).toBe(500);
expect(oversizedDescription.body.error).toContain("Description must not exceed 5000 characters");
});
it("mission update validates invalid status values", async () => {
const { app, missionStore } = buildApp({ withErrorHandler: true });
const mission = missionStore.createMission({ title: "Mission" });
const invalid = await request(
app,
"PATCH",
`/api/missions/${mission.id}`,
JSON.stringify({ status: "bogus" }),
{ "content-type": "application/json" },
);
expect(invalid.status).toBe(500);
expect(invalid.body.error).toContain("Invalid status");
});
it("mission creation rejects non-boolean autoAdvance", async () => {
const { app } = buildApp({ withErrorHandler: true });
const invalid = await request(
app,
"POST",
"/api/missions",
JSON.stringify({ title: "Mission", autoAdvance: "yes" }),
{ "content-type": "application/json" },
);
expect(invalid.status).toBe(500);
expect(invalid.body.error).toContain("autoAdvance must be a boolean");
});
it("400-level route validation responses return explicit route messages", async () => {
const { app } = buildApp();
const invalidMissionId = await get(app, "/api/missions/invalid-id/status");
expect(invalidMissionId.status).toBe(400);
expect(invalidMissionId.body).toEqual({ error: "Invalid mission ID format" });
const invalidFeatureId = await request(app, "DELETE", "/api/missions/features/invalid-id");
expect(invalidFeatureId.status).toBe(400);
expect(invalidFeatureId.body).toEqual({ error: "Invalid feature ID format" });
});
});
describe("Interview endpoints", () => { beforeEach(() => {
__resetMissionInterviewState();
});

View File

@@ -1,15 +1,115 @@
// @vitest-environment node
import { beforeEach, describe, expect, it, vi } from "vitest";
import { EventEmitter } from "node:events";
import ts from "typescript";
import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
import type { AiSessionRow } from "./ai-session-store.js";
// @ts-expect-error Vite raw loader import for source-level utility tests
import subtaskBreakdownSource from "./subtask-breakdown.ts?raw";
import {
__resetSubtaskBreakdownState,
cancelSubtaskSession,
cleanupSubtaskSession,
createSubtaskSession,
getSubtaskSession,
rehydrateFromStore,
SessionNotFoundError,
setAiSessionStore,
subtaskStreamManager,
SubtaskStreamManager,
} from "./subtask-breakdown.js";
import type { AiSessionRow } from "./ai-session-store.js";
const UUID_REGEX =
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
type InternalSubtaskFns = {
parseSubtasks: (text: string) => Array<{
id: string;
title: string;
description: string;
suggestedSize: "S" | "M" | "L";
dependsOn: string[];
}>;
normalizeSubtaskItem: (
item: Partial<{
id: string;
title: string;
description: string;
suggestedSize: "S" | "M" | "L" | "";
dependsOn: unknown[];
}>,
index?: number,
) => {
id: string;
title: string;
description: string;
suggestedSize: "S" | "M" | "L";
dependsOn: string[];
};
generateFallbackSubtasks: (initialDescription: string) => Array<{
id: string;
title: string;
description: string;
suggestedSize: "S" | "M" | "L";
dependsOn: string[];
}>;
};
function extractFunctionSource(startToken: string, endToken: string): string {
const start = subtaskBreakdownSource.indexOf(startToken);
if (start < 0) {
throw new Error(`Unable to find function start token: ${startToken}`);
}
const end = subtaskBreakdownSource.indexOf(endToken, start);
if (end < 0) {
throw new Error(`Unable to find function end token: ${endToken}`);
}
return subtaskBreakdownSource.slice(start, end).trim();
}
async function loadInternalSubtaskFunctions(): Promise<InternalSubtaskFns> {
const parseSource = extractFunctionSource(
"function parseSubtasks",
"\nfunction normalizeSubtaskItem",
);
const normalizeSource = extractFunctionSource(
"function normalizeSubtaskItem",
"\nfunction generateFallbackSubtasks",
);
const fallbackSource = extractFunctionSource(
"function generateFallbackSubtasks",
"\nfunction completeSession",
);
const utilityModuleSource = `
type SubtaskItem = {
id: string;
title: string;
description: string;
suggestedSize: "S" | "M" | "L";
dependsOn: string[];
};
${parseSource}
${normalizeSource}
${fallbackSource}
export { parseSubtasks, normalizeSubtaskItem, generateFallbackSubtasks };
`;
const transpiled = ts.transpileModule(utilityModuleSource, {
compilerOptions: {
module: ts.ModuleKind.ESNext,
target: ts.ScriptTarget.ES2022,
},
}).outputText;
const moduleUrl = `data:text/javascript;base64,${Buffer.from(transpiled).toString("base64")}`;
return (await import(moduleUrl)) as InternalSubtaskFns;
}
let internalFns: InternalSubtaskFns;
class MockAiSessionStore extends EventEmitter {
rows = new Map<string, AiSessionRow>();
@@ -65,81 +165,267 @@ function buildSubtaskRow(
};
}
describe("subtask-breakdown stream buffering", () => {
beforeEach(() => {
__resetSubtaskBreakdownState();
});
beforeAll(async () => {
internalFns = await loadInternalSubtaskFunctions();
});
it("buffers broadcast events and forwards ids to subscribers", () => {
const sessionId = "subtask-session-1";
afterEach(() => {
__resetSubtaskBreakdownState();
vi.restoreAllMocks();
});
describe("SubtaskStreamManager", () => {
it("subscribe/broadcast delivers events and unsubscribe stops delivery", () => {
const manager = new SubtaskStreamManager();
const callback = vi.fn();
const unsubscribe = subtaskStreamManager.subscribe(sessionId, callback);
const unsubscribe = manager.subscribe("session-1", callback);
const firstId = subtaskStreamManager.broadcast(sessionId, {
type: "thinking",
data: "delta-1",
});
const secondId = subtaskStreamManager.broadcast(sessionId, {
type: "subtasks",
data: [
{
id: "subtask-1",
title: "Title",
description: "Description",
suggestedSize: "S",
dependsOn: [],
},
],
});
expect(firstId).toBe(1);
expect(secondId).toBe(2);
expect(callback).toHaveBeenNthCalledWith(1, { type: "thinking", data: "delta-1" }, 1);
expect(callback).toHaveBeenNthCalledWith(2, expect.objectContaining({ type: "subtasks" }), 2);
const buffered = subtaskStreamManager.getBufferedEvents(sessionId, 1);
expect(buffered).toHaveLength(1);
expect(buffered[0]).toMatchObject({ id: 2, event: "subtasks" });
manager.broadcast("session-1", { type: "thinking", data: "first delta" });
expect(callback).toHaveBeenCalledTimes(1);
expect(callback).toHaveBeenCalledWith(
{ type: "thinking", data: "first delta" },
expect.any(Number),
);
unsubscribe();
manager.broadcast("session-1", { type: "thinking", data: "second delta" });
expect(callback).toHaveBeenCalledTimes(1);
expect(() => manager.broadcast("missing-session", { type: "complete" })).not.toThrow();
});
it("buffers complete events without subscribers", () => {
const sessionId = "subtask-session-2";
it("cleanupSession removes subscribers and prior buffered events", () => {
const manager = new SubtaskStreamManager();
const callback = vi.fn();
const eventId = subtaskStreamManager.broadcast(sessionId, { type: "complete" });
manager.subscribe("session-2", callback);
manager.broadcast("session-2", { type: "thinking", data: "before cleanup" });
expect(eventId).toBe(1);
expect(subtaskStreamManager.getBufferedEvents(sessionId, 0)).toEqual([
{ id: 1, event: "complete", data: "{}" },
expect(manager.getBufferedEvents("session-2", 0)).toHaveLength(1);
manager.cleanupSession("session-2");
manager.broadcast("session-2", { type: "thinking", data: "after cleanup" });
expect(callback).toHaveBeenCalledTimes(1);
expect(manager.getBufferedEvents("session-2", 0)).toEqual([
{ id: 1, event: "thinking", data: JSON.stringify("after cleanup") },
]);
});
it("clears subscriptions and buffered events on cleanupSession", () => {
const sessionId = "subtask-session-3";
const callback = vi.fn();
it("notifies multiple subscribers and isolates subscriber errors", () => {
const manager = new SubtaskStreamManager();
const goodSubscriber = vi.fn();
const throwingSubscriber = vi.fn(() => {
throw new Error("subscriber failed");
});
subtaskStreamManager.subscribe(sessionId, callback);
subtaskStreamManager.broadcast(sessionId, { type: "thinking", data: "delta" });
manager.subscribe("session-3", throwingSubscriber);
manager.subscribe("session-3", goodSubscriber);
expect(subtaskStreamManager.getBufferedEvents(sessionId, 0)).toHaveLength(1);
expect(() =>
manager.broadcast("session-3", { type: "subtasks", data: [] }),
).not.toThrow();
subtaskStreamManager.cleanupSession(sessionId);
expect(subtaskStreamManager.getBufferedEvents(sessionId, 0)).toEqual([]);
expect(throwingSubscriber).toHaveBeenCalledTimes(1);
expect(goodSubscriber).toHaveBeenCalledTimes(1);
});
});
describe("subtask-breakdown rehydration", () => {
beforeEach(() => {
__resetSubtaskBreakdownState();
describe("normalizeSubtaskItem", () => {
it("keeps valid items unchanged", () => {
const result = internalFns.normalizeSubtaskItem(
{
id: "subtask-9",
title: "Title",
description: "Description",
suggestedSize: "L",
dependsOn: ["subtask-1"],
},
8,
);
expect(result).toEqual({
id: "subtask-9",
title: "Title",
description: "Description",
suggestedSize: "L",
dependsOn: ["subtask-1"],
});
});
it("fills default id, suggestedSize, and dependsOn when fields are missing", () => {
const result = internalFns.normalizeSubtaskItem(
{
title: " Plan ",
description: " Work ",
},
1,
);
expect(result).toEqual({
id: "subtask-2",
title: "Plan",
description: "Work",
suggestedSize: "M",
dependsOn: [],
});
});
it("defaults empty suggestedSize and filters non-string dependsOn entries", () => {
const result = internalFns.normalizeSubtaskItem(
{
id: "",
title: "Task",
description: "Desc",
suggestedSize: "",
dependsOn: ["subtask-1", 123, null, "subtask-2"],
},
0,
);
expect(result.id).toBe("subtask-1");
expect(result.suggestedSize).toBe("M");
expect(result.dependsOn).toEqual(["subtask-1", "subtask-2"]);
});
});
describe("parseSubtasks", () => {
it("parses markdown-wrapped JSON and normalizes items", () => {
const parsed = internalFns.parseSubtasks(`\`\`\`json\n{"subtasks":[{"title":"First"}]}\n\`\`\``);
expect(parsed).toHaveLength(1);
expect(parsed[0]).toMatchObject({
id: "subtask-1",
title: "First",
description: "",
suggestedSize: "M",
dependsOn: [],
});
});
it("parses raw JSON objects", () => {
const parsed = internalFns.parseSubtasks(
JSON.stringify({
subtasks: [
{
id: "subtask-1",
title: "First",
description: "Do first",
suggestedSize: "S",
dependsOn: [],
},
],
}),
);
expect(parsed[0].title).toBe("First");
});
it("throws for invalid JSON, missing subtasks key, and empty subtasks array", () => {
expect(() => internalFns.parseSubtasks("not-json")).toThrow();
expect(() => internalFns.parseSubtasks(JSON.stringify({ foo: [] }))).toThrow(
"AI did not return a valid subtasks array",
);
expect(() => internalFns.parseSubtasks(JSON.stringify({ subtasks: [] }))).toThrow(
"AI did not return a valid subtasks array",
);
});
});
describe("generateFallbackSubtasks", () => {
it("returns three sequential subtasks with expected dependency chain", () => {
const description = "Implement a new dashboard flow";
const subtasks = internalFns.generateFallbackSubtasks(description);
expect(subtasks).toHaveLength(3);
expect(subtasks[0]).toMatchObject({ id: "subtask-1", dependsOn: [] });
expect(subtasks[1]).toMatchObject({ id: "subtask-2", dependsOn: ["subtask-1"] });
expect(subtasks[2]).toMatchObject({ id: "subtask-3", dependsOn: ["subtask-2"] });
expect(subtasks[0].description).toContain(description);
for (const subtask of subtasks) {
expect(["S", "M"]).toContain(subtask.suggestedSize);
}
});
});
describe("subtask session lifecycle", () => {
it("createSubtaskSession returns generating session metadata", async () => {
const description = "Build dashboard coverage tests for mission routes";
const created = await createSubtaskSession(description);
expect(created).toEqual({
sessionId: expect.stringMatching(UUID_REGEX),
initialDescription: description,
subtasks: [],
status: "generating",
createdAt: expect.any(Date),
});
const inMemory = getSubtaskSession(created.sessionId);
expect(inMemory).toBeDefined();
expect(inMemory).toMatchObject({
sessionId: created.sessionId,
initialDescription: description,
status: "generating",
subtasks: [],
createdAt: expect.any(Date),
});
});
it("getSubtaskSession returns undefined for unknown session and public shape for known session", async () => {
expect(getSubtaskSession("unknown-session")).toBeUndefined();
const created = await createSubtaskSession("Public session shape verification");
const session = getSubtaskSession(created.sessionId);
expect(session).toBeDefined();
expect(session).toMatchObject({
sessionId: created.sessionId,
initialDescription: "Public session shape verification",
status: "generating",
subtasks: [],
createdAt: expect.any(Date),
});
expect(session).not.toHaveProperty("updatedAt");
expect(session).not.toHaveProperty("agent");
expect(session).not.toHaveProperty("thinkingOutput");
});
it("cancelSubtaskSession throws SessionNotFoundError for unknown session", async () => {
await expect(cancelSubtaskSession("missing-session")).rejects.toMatchObject({
name: "SessionNotFoundError",
});
});
it("cancelSubtaskSession removes an existing session", async () => {
const created = await createSubtaskSession("Cancel active session");
await cancelSubtaskSession(created.sessionId);
expect(getSubtaskSession(created.sessionId)).toBeUndefined();
});
it("cleanupSubtaskSession is idempotent", async () => {
const created = await createSubtaskSession("Cleanup idempotency");
expect(() => cleanupSubtaskSession(created.sessionId)).not.toThrow();
expect(() => cleanupSubtaskSession(created.sessionId)).not.toThrow();
expect(getSubtaskSession(created.sessionId)).toBeUndefined();
});
});
describe("subtask session rehydration", () => {
it("rehydrates recoverable subtask sessions from SQLite rows", () => {
const store = new MockAiSessionStore();
const subtaskRow = buildSubtaskRow({ id: "subtask-rehydrate-1", status: "generating" });
const planningRow = buildSubtaskRow({ id: "planning-rehydrate-1", status: "awaiting_input", type: "planning" });
const planningRow = buildSubtaskRow({
id: "planning-rehydrate-1",
status: "awaiting_input",
type: "planning",
});
store.rows.set(subtaskRow.id, subtaskRow);
store.rows.set(planningRow.id, planningRow);
@@ -179,7 +465,6 @@ describe("subtask-breakdown rehydration", () => {
`[subtask-breakdown] Failed to rehydrate session ${badRow.id}:`,
expect.any(Error),
);
errorSpy.mockRestore();
});
it("falls through to SQLite when session is missing in memory", () => {
@@ -219,11 +504,14 @@ describe("subtask-breakdown rehydration", () => {
expect(session?.initialDescription).toBe("Break this task down");
expect(getSpy).not.toHaveBeenCalled();
});
});
it("returns undefined when session exists nowhere", () => {
const store = new MockAiSessionStore();
setAiSessionStore(store as any);
describe("SessionNotFoundError", () => {
it("is an Error subtype with SessionNotFoundError name", () => {
const error = new SessionNotFoundError("Missing session");
expect(getSubtaskSession("missing-subtask-session")).toBeUndefined();
expect(error).toBeInstanceOf(Error);
expect(error.name).toBe("SessionNotFoundError");
expect(error.message).toBe("Missing session");
});
});