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>

src/cli/install.test.ts

@@ -17,7 +17,7 @@ describe("install CLI - binary check behavior", () => {
   let getOpenCodeVersionSpy: ReturnType<typeof spyOn>
 
   beforeEach(() => {
-    // #given temporary config directory
+    // given temporary config directory
     tempDir = join(tmpdir(), `omo-test-${Date.now()}-${Math.random().toString(36).slice(2)}`)
     mkdirSync(tempDir, { recursive: true })
 
@@ -49,7 +49,7 @@ describe("install CLI - binary check behavior", () => {
   })
 
   test("non-TUI mode: should show warning but continue when OpenCode binary not found", async () => {
-    // #given OpenCode binary is NOT installed
+    // given OpenCode binary is NOT installed
     isOpenCodeInstalledSpy = spyOn(configManager, "isOpenCodeInstalled").mockResolvedValue(false)
     getOpenCodeVersionSpy = spyOn(configManager, "getOpenCodeVersion").mockResolvedValue(null)
 
@@ -63,24 +63,24 @@ describe("install CLI - binary check behavior", () => {
       zaiCodingPlan: "no",
     }
 
-    // #when running install
+    // when running install
     const exitCode = await install(args)
 
-    // #then should return success (0), not failure (1)
+    // then should return success (0), not failure (1)
     expect(exitCode).toBe(0)
 
-    // #then should have printed a warning (not error)
+    // then should have printed a warning (not error)
     const allCalls = mockConsoleLog.mock.calls.flat().join("\n")
     expect(allCalls).toContain("[!]") // warning symbol
     expect(allCalls).toContain("OpenCode")
   })
 
   test("non-TUI mode: should create opencode.json with plugin even when binary not found", async () => {
-    // #given OpenCode binary is NOT installed
+    // given OpenCode binary is NOT installed
     isOpenCodeInstalledSpy = spyOn(configManager, "isOpenCodeInstalled").mockResolvedValue(false)
     getOpenCodeVersionSpy = spyOn(configManager, "getOpenCodeVersion").mockResolvedValue(null)
 
-    // #given mock npm fetch
+    // given mock npm fetch
     globalThis.fetch = mock(() =>
       Promise.resolve({
         ok: true,
@@ -98,28 +98,28 @@ describe("install CLI - binary check behavior", () => {
       zaiCodingPlan: "no",
     }
 
-    // #when running install
+    // when running install
     const exitCode = await install(args)
 
-    // #then should create opencode.json
+    // then should create opencode.json
     const configPath = join(tempDir, "opencode.json")
     expect(existsSync(configPath)).toBe(true)
 
-    // #then opencode.json should have plugin entry
+    // then opencode.json should have plugin entry
     const config = JSON.parse(readFileSync(configPath, "utf-8"))
     expect(config.plugin).toBeDefined()
     expect(config.plugin.some((p: string) => p.includes("oh-my-opencode"))).toBe(true)
 
-    // #then exit code should be 0 (success)
+    // then exit code should be 0 (success)
     expect(exitCode).toBe(0)
   })
 
   test("non-TUI mode: should still succeed and complete all steps when binary exists", async () => {
-    // #given OpenCode binary IS installed
+    // given OpenCode binary IS installed
     isOpenCodeInstalledSpy = spyOn(configManager, "isOpenCodeInstalled").mockResolvedValue(true)
     getOpenCodeVersionSpy = spyOn(configManager, "getOpenCodeVersion").mockResolvedValue("1.0.200")
 
-    // #given mock npm fetch
+    // given mock npm fetch
     globalThis.fetch = mock(() =>
       Promise.resolve({
         ok: true,
@@ -137,13 +137,13 @@ describe("install CLI - binary check behavior", () => {
       zaiCodingPlan: "no",
     }
 
-    // #when running install
+    // when running install
     const exitCode = await install(args)
 
-    // #then should return success
+    // then should return success
     expect(exitCode).toBe(0)
 
-    // #then should have printed success (OK symbol)
+    // then should have printed success (OK symbol)
     const allCalls = mockConsoleLog.mock.calls.flat().join("\n")
     expect(allCalls).toContain("[OK]")
     expect(allCalls).toContain("OpenCode 1.0.200")