refactor: major codebase cleanup - BDD comments, file splitting, bug fixes (#1350)

* style(tests): normalize BDD comments from '// #given' to '// given'

- Replace 4,668 Python-style BDD comments across 107 test files
- Patterns changed: // #given -> // given, // #when -> // when, // #then -> // then
- Also handles no-space variants: //#given -> // given

* fix(rules-injector): prefer output.metadata.filePath over output.title

- Extract file path resolution to dedicated output-path.ts module
- Prefer metadata.filePath which contains actual file path
- Fall back to output.title only when metadata unavailable
- Fixes issue where rules weren't injected when tool output title was a label

* feat(slashcommand): add optional user_message parameter

- Add user_message optional parameter for command arguments
- Model can now call: command='publish' user_message='patch'
- Improves error messages with clearer format guidance
- Helps LLMs understand correct parameter usage

* feat(hooks): restore compaction-context-injector hook

- Restore hook deleted in cbbc7bd0 for session compaction context
- Injects 7 mandatory sections: User Requests, Final Goal, Work Completed,
  Remaining Tasks, Active Working Context, MUST NOT Do, Agent Verification State
- Re-register in hooks/index.ts and main plugin entry

* refactor(background-agent): split manager.ts into focused modules

- Extract constants.ts for TTL values and internal types (52 lines)
- Extract state.ts for TaskStateManager class (204 lines)
- Extract spawner.ts for task creation logic (244 lines)
- Extract result-handler.ts for completion handling (265 lines)
- Reduce manager.ts from 1377 to 755 lines (45% reduction)
- Maintain backward compatible exports

* refactor(agents): split prometheus-prompt.ts into subdirectory

- Move 1196-line prometheus-prompt.ts to prometheus/ subdirectory
- Organize prompt sections into separate files for maintainability
- Update agents/index.ts exports

* refactor(delegate-task): split tools.ts into focused modules

- Extract categories.ts for category definitions and routing
- Extract executor.ts for task execution logic
- Extract helpers.ts for utility functions
- Extract prompt-builder.ts for prompt construction
- Reduce tools.ts complexity with cleaner separation of concerns

* refactor(builtin-skills): split skills.ts into individual skill files

- Move each skill to dedicated file in skills/ subdirectory
- Create barrel export for backward compatibility
- Improve maintainability with focused skill modules

* chore: update import paths and lockfile

- Update prometheus import path after refactor
- Update bun.lock

* fix(tests): complete BDD comment normalization

- Fix remaining #when/#then patterns missed by initial sed
- Affected: state.test.ts, events.test.ts

---------

Co-authored-by: justsisyphus <justsisyphus@users.noreply.github.com>
This commit is contained in:
YeonGyu-Kim
2026-02-01 16:47:50 +09:00
committed by GitHub
parent c83150d9ea
commit f146aeff0f
145 changed files with 10307 additions and 9562 deletions
+46 -46
View File
@@ -11,7 +11,7 @@ describe("ContextCollector", () => {
describe("register", () => {
it("registers context for a session", () => {
// #given
// given
const sessionID = "ses_test1"
const options = {
id: "ulw-context",
@@ -19,10 +19,10 @@ describe("ContextCollector", () => {
content: "Ultrawork mode activated",
}
// #when
// when
collector.register(sessionID, options)
// #then
// then
const pending = collector.getPending(sessionID)
expect(pending.hasContent).toBe(true)
expect(pending.entries).toHaveLength(1)
@@ -30,26 +30,26 @@ describe("ContextCollector", () => {
})
it("assigns default priority of 'normal' when not specified", () => {
// #given
// given
const sessionID = "ses_test2"
// #when
// when
collector.register(sessionID, {
id: "test",
source: "keyword-detector",
content: "test content",
})
// #then
// then
const pending = collector.getPending(sessionID)
expect(pending.entries[0].priority).toBe("normal")
})
it("uses specified priority", () => {
// #given
// given
const sessionID = "ses_test3"
// #when
// when
collector.register(sessionID, {
id: "critical-context",
source: "keyword-detector",
@@ -57,13 +57,13 @@ describe("ContextCollector", () => {
priority: "critical",
})
// #then
// then
const pending = collector.getPending(sessionID)
expect(pending.entries[0].priority).toBe("critical")
})
it("deduplicates by source + id combination", () => {
// #given
// given
const sessionID = "ses_test4"
const options = {
id: "ulw-context",
@@ -71,21 +71,21 @@ describe("ContextCollector", () => {
content: "First content",
}
// #when
// when
collector.register(sessionID, options)
collector.register(sessionID, { ...options, content: "Updated content" })
// #then
// then
const pending = collector.getPending(sessionID)
expect(pending.entries).toHaveLength(1)
expect(pending.entries[0].content).toBe("Updated content")
})
it("allows same id from different sources", () => {
// #given
// given
const sessionID = "ses_test5"
// #when
// when
collector.register(sessionID, {
id: "context-1",
source: "keyword-detector",
@@ -97,7 +97,7 @@ describe("ContextCollector", () => {
content: "From rules-injector",
})
// #then
// then
const pending = collector.getPending(sessionID)
expect(pending.entries).toHaveLength(2)
})
@@ -105,20 +105,20 @@ describe("ContextCollector", () => {
describe("getPending", () => {
it("returns empty result for session with no context", () => {
// #given
// given
const sessionID = "ses_empty"
// #when
// when
const pending = collector.getPending(sessionID)
// #then
// then
expect(pending.hasContent).toBe(false)
expect(pending.entries).toHaveLength(0)
expect(pending.merged).toBe("")
})
it("merges multiple contexts with separator", () => {
// #given
// given
const sessionID = "ses_merge"
collector.register(sessionID, {
id: "ctx-1",
@@ -131,17 +131,17 @@ describe("ContextCollector", () => {
content: "Second context",
})
// #when
// when
const pending = collector.getPending(sessionID)
// #then
// then
expect(pending.hasContent).toBe(true)
expect(pending.merged).toContain("First context")
expect(pending.merged).toContain("Second context")
})
it("orders contexts by priority (critical > high > normal > low)", () => {
// #given
// given
const sessionID = "ses_priority"
collector.register(sessionID, {
id: "low",
@@ -168,16 +168,16 @@ describe("ContextCollector", () => {
priority: "high",
})
// #when
// when
const pending = collector.getPending(sessionID)
// #then
// then
const order = pending.entries.map((e) => e.priority)
expect(order).toEqual(["critical", "high", "normal", "low"])
})
it("maintains registration order within same priority", () => {
// #given
// given
const sessionID = "ses_order"
collector.register(sessionID, {
id: "first",
@@ -198,10 +198,10 @@ describe("ContextCollector", () => {
priority: "normal",
})
// #when
// when
const pending = collector.getPending(sessionID)
// #then
// then
const ids = pending.entries.map((e) => e.id)
expect(ids).toEqual(["first", "second", "third"])
})
@@ -209,7 +209,7 @@ describe("ContextCollector", () => {
describe("consume", () => {
it("clears pending context for session", () => {
// #given
// given
const sessionID = "ses_consume"
collector.register(sessionID, {
id: "ctx",
@@ -217,16 +217,16 @@ describe("ContextCollector", () => {
content: "test",
})
// #when
// when
collector.consume(sessionID)
// #then
// then
const pending = collector.getPending(sessionID)
expect(pending.hasContent).toBe(false)
})
it("returns the consumed context", () => {
// #given
// given
const sessionID = "ses_consume_return"
collector.register(sessionID, {
id: "ctx",
@@ -234,16 +234,16 @@ describe("ContextCollector", () => {
content: "test content",
})
// #when
// when
const consumed = collector.consume(sessionID)
// #then
// then
expect(consumed.hasContent).toBe(true)
expect(consumed.entries[0].content).toBe("test content")
})
it("does not affect other sessions", () => {
// #given
// given
const session1 = "ses_1"
const session2 = "ses_2"
collector.register(session1, {
@@ -257,10 +257,10 @@ describe("ContextCollector", () => {
content: "session 2",
})
// #when
// when
collector.consume(session1)
// #then
// then
expect(collector.getPending(session1).hasContent).toBe(false)
expect(collector.getPending(session2).hasContent).toBe(true)
})
@@ -268,7 +268,7 @@ describe("ContextCollector", () => {
describe("clear", () => {
it("removes all context for a session", () => {
// #given
// given
const sessionID = "ses_clear"
collector.register(sessionID, {
id: "ctx-1",
@@ -281,17 +281,17 @@ describe("ContextCollector", () => {
content: "test 2",
})
// #when
// when
collector.clear(sessionID)
// #then
// then
expect(collector.getPending(sessionID).hasContent).toBe(false)
})
})
describe("hasPending", () => {
it("returns true when session has pending context", () => {
// #given
// given
const sessionID = "ses_has"
collector.register(sessionID, {
id: "ctx",
@@ -299,20 +299,20 @@ describe("ContextCollector", () => {
content: "test",
})
// #when / #then
// when / #then
expect(collector.hasPending(sessionID)).toBe(true)
})
it("returns false when session has no pending context", () => {
// #given
// given
const sessionID = "ses_empty"
// #when / #then
// when / #then
expect(collector.hasPending(sessionID)).toBe(false)
})
it("returns false after consume", () => {
// #given
// given
const sessionID = "ses_after_consume"
collector.register(sessionID, {
id: "ctx",
@@ -320,10 +320,10 @@ describe("ContextCollector", () => {
content: "test",
})
// #when
// when
collector.consume(sessionID)
// #then
// then
expect(collector.hasPending(sessionID)).toBe(false)
})
})
+12 -12
View File
@@ -37,7 +37,7 @@ describe("createContextInjectorMessagesTransformHook", () => {
})
it("inserts synthetic part before text part in last user message", async () => {
// #given
// given
const hook = createContextInjectorMessagesTransformHook(collector)
const sessionID = "ses_transform1"
collector.register(sessionID, {
@@ -53,10 +53,10 @@ describe("createContextInjectorMessagesTransformHook", () => {
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const output = { messages } as any
// #when
// when
await hook["experimental.chat.messages.transform"]!({}, output)
// #then - synthetic part inserted before original text part
// then - synthetic part inserted before original text part
expect(output.messages.length).toBe(3)
expect(output.messages[2].parts.length).toBe(2)
expect(output.messages[2].parts[0].text).toBe("Ultrawork context")
@@ -65,22 +65,22 @@ describe("createContextInjectorMessagesTransformHook", () => {
})
it("does nothing when no pending context", async () => {
// #given
// given
const hook = createContextInjectorMessagesTransformHook(collector)
const sessionID = "ses_transform2"
const messages = [createMockMessage("user", "Hello world", sessionID)]
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const output = { messages } as any
// #when
// when
await hook["experimental.chat.messages.transform"]!({}, output)
// #then
// then
expect(output.messages.length).toBe(1)
})
it("does nothing when no user messages", async () => {
// #given
// given
const hook = createContextInjectorMessagesTransformHook(collector)
const sessionID = "ses_transform3"
collector.register(sessionID, {
@@ -92,16 +92,16 @@ describe("createContextInjectorMessagesTransformHook", () => {
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const output = { messages } as any
// #when
// when
await hook["experimental.chat.messages.transform"]!({}, output)
// #then
// then
expect(output.messages.length).toBe(1)
expect(collector.hasPending(sessionID)).toBe(true)
})
it("consumes context after injection", async () => {
// #given
// given
const hook = createContextInjectorMessagesTransformHook(collector)
const sessionID = "ses_transform4"
collector.register(sessionID, {
@@ -113,10 +113,10 @@ describe("createContextInjectorMessagesTransformHook", () => {
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const output = { messages } as any
// #when
// when
await hook["experimental.chat.messages.transform"]!({}, output)
// #then
// then
expect(collector.hasPending(sessionID)).toBe(false)
})
})