feat(scm): add Source Control button for commit message generation

Wires the generator into VS Code. Part 3 of 4 for AI commit-message generation:
a button in the Source Control panel that writes a message into the commit box.

The command is contributed to both `scm/title` and `scm/inputBox`, so it is
reachable from the panel header and from the commit box itself.

Nothing the user has typed is ever overwritten. A non-empty box short-circuits
before any request is made, rather than spending tokens on a message that would
be discarded, and the box is compared against its captured value afterwards so
text typed while the request was in flight survives too. Only a box that was
empty at the start and is still empty at the end gets written to.

The target repository is now resolved rather than assumed. The SCM menus pass the
`SourceControl` that was clicked, which identifies it exactly; without one, the
only unambiguous case is a workspace with a single repository. Previously this
fell back to `repositories[0]`, which in a multi-root workspace would eventually
describe one repository's changes in another's commit box.

Each `getCommitContext` outcome now gets its own response: no changes is
informational, a collection failure reports why, and a missing repository is
reported as such rather than as "no changes".

`packages/build` gains a test for the command icon schema. That field was widened
to accept a `{light, dark}` pair for this button, and the existing fixtures only
use codicon strings, so nothing would have caught it being narrowed back.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: Rafael-Silva-Oliveira

packages/build/src/__tests__/types.test.ts

@@ -0,0 +1,29 @@
+// npx vitest run src/__tests__/types.test.ts
+
+import { contributesSchema } from "../types.js"
+
+describe("contributes commands schema", () => {
+	// Reached through `.shape` so this stays focused on the icon field, without needing a whole
+	// valid `contributes` object around it.
+	const commandsSchema = contributesSchema.shape.commands
+
+	const command = (icon: unknown) => [
+		{ command: "zoo-code.generateCommitMessage", title: "%command.generateCommitMessage.title%", icon },
+	]
+
+	it("accepts a codicon reference", () => {
+		expect(commandsSchema.safeParse(command("$(edit)")).success).toBe(true)
+	})
+
+	// The Source Control button ships a PNG per theme rather than a codicon. This field used to
+	// allow only a string, which rejected the manifest outright when generating the nightly build.
+	it("accepts a pair of theme-specific icon paths", () => {
+		const icon = { light: "assets/icons/panel_light.png", dark: "assets/icons/panel_dark.png" }
+
+		expect(commandsSchema.safeParse(command(icon)).success).toBe(true)
+	})
+
+	it("rejects an icon pair that is missing a theme", () => {
+		expect(commandsSchema.safeParse(command({ light: "assets/icons/panel_light.png" })).success).toBe(false)
+	})
+})

packages/build/src/types.ts

@@ -31,7 +31,8 @@ const commandsSchema = z.array(
 		command: z.string(),
 		title: z.string(),
 		category: z.string().optional(),
-		icon: z.string().optional(),
+		// Either a codicon reference (e.g. `$(edit)`) or a pair of theme-specific image paths.
+		icon: z.union([z.string(), z.object({ light: z.string(), dark: z.string() })]).optional(),
 	}),
 )
 

packages/types/src/vscode.ts

@@ -47,6 +47,8 @@ export const commandIds = [
 	"focusPanel",
 	"toggleAutoApprove",
 
+	"generateCommitMessage",
+
 	"showRipgrepDiagnostic",
 ] as const
 

src/activate/__tests__/registerCommands.spec.ts

@@ -89,6 +89,10 @@ vi.mock("../../i18n", () => ({
 	t: (key: string) => key,
 }))
 
+vi.mock("../../services/commit-message", () => ({
+	generateCommitMessage: vi.fn().mockResolvedValue(undefined),
+}))
+
 vi.mock("../../services/ripgrep/diagnostic", () => ({
 	registerRipgrepDiagnosticCommand: vi.fn().mockReturnValue({ dispose: vi.fn() }),
 }))
@@ -192,6 +196,17 @@ describe("registerCommands handlers", () => {
 		expect(mockContext.subscriptions).toContain(disposable)
 	})
 
+	it("generateCommitMessage forwards the clicked source control to the generator", async () => {
+		const { generateCommitMessage } = await import("../../services/commit-message")
+		const sourceControl = { rootUri: { fsPath: "/repo" } }
+
+		await handlers["zoo-code.generateCommitMessage"](sourceControl)
+
+		// Uses the registered provider rather than the visible one, so the Source Control button
+		// still works while the Zoo Code sidebar is closed.
+		expect(vi.mocked(generateCommitMessage)).toHaveBeenCalledWith(mockProvider, sourceControl)
+	})
+
 	it("settingsButtonClicked posts both settingsButtonClicked and didBecomeVisible actions", () => {
 		handlers["zoo-code.settingsButtonClicked"]()
 

src/activate/registerCommands.ts

@@ -14,6 +14,7 @@ import { CodeIndexManager } from "../services/code-index/manager"
 import { importSettingsWithFeedback } from "../core/config/importExport"
 import { MdmService } from "../services/mdm/MdmService"
 import { registerRipgrepDiagnosticCommand } from "../services/ripgrep/diagnostic"
+import { generateCommitMessage } from "../services/commit-message"
 import { t } from "../i18n"
 
 /**
@@ -219,6 +220,9 @@ const getCommandsMap = ({
 			outputChannel.appendLine(`[toggleAutoApprove] postMessageToWebview failed: ${error}`)
 		}
 	},
+	// Uses `provider` rather than the visible instance so the Source Control button still works
+	// while the Zoo Code sidebar is closed.
+	generateCommitMessage: (sourceControl?: vscode.SourceControl) => generateCommitMessage(provider, sourceControl),
 })
 
 export const openClineInNewTab = async ({ context, outputChannel }: Omit<RegisterCommandOptions, "provider">) => {

src/i18n/locales/ca/common.json

@@ -41,6 +41,9 @@
 		"reset_support_prompt": "Failed to reset support prompt",
 		"enhance_prompt": "Failed to enhance prompt",
 		"commit_message_empty_response": "The model returned an empty commit message.",
+		"commit_message_no_repository": "No Git repository found in the Source Control panel.",
+		"commit_message_failed": "Failed to generate commit message: {{error}}",
+		"commit_message_ambiguous_repository": "Several Git repositories are open. Use the Zoo Code button in the Source Control panel of the repository you want.",
 		"get_system_prompt": "Failed to get system prompt",
 		"search_commits": "Failed to search commits",
 		"save_api_config": "Failed to save api configuration",
@@ -161,6 +164,10 @@
 	},
 	"info": {
 		"no_changes": "No changes found.",
+		"commit_message_generating": "Generating commit message...",
+		"commit_message_no_changes": "No changes to commit.",
+		"commit_message_box_not_empty": "Kept your commit message. Clear the box to generate a new one.",
+		"commit_message_already_generating": "Already generating a commit message.",
 		"clipboard_copy": "System prompt successfully copied to clipboard",
 		"history_cleanup": "Cleaned up {{count}} task(s) with missing files from history.",
 		"custom_storage_path_set": "Custom storage path set: {{path}}",