@lumenflow/cli 5.4.0 → 5.7.12

package/packs/software-delivery/tool-impl/wu-lifecycle-tools.ts

@@ -1,807 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
-
-import type { ToolOutput } from '@lumenflow/kernel';
-import { RUNTIME_CLI_COMMANDS, runtimeCliAdapter } from './runtime-cli-adapter.js';
-
-const LIFECYCLE_TOOLS = {
-  WU_STATUS: 'wu:status',
-  WU_CREATE: 'wu:create',
-  WU_CLAIM: 'wu:claim',
-  WU_PREP: 'wu:prep',
-  WU_DONE: 'wu:done',
-  WU_SANDBOX: 'wu:sandbox',
-  WU_PRUNE: 'wu:prune',
-  WU_DELETE: 'wu:delete',
-  WU_CLEANUP: 'wu:cleanup',
-  WU_UNLOCK_LANE: 'wu:unlock-lane',
-  WU_BRIEF: 'wu:brief',
-  WU_DELEGATE: 'wu:delegate',
-  WU_DEPS: 'wu:deps',
-  WU_EDIT: 'wu:edit',
-  WU_PROTO: 'wu:proto',
-  WU_PREFLIGHT: 'wu:preflight',
-  WU_VALIDATE: 'wu:validate',
-  WU_BLOCK: 'wu:block',
-  WU_UNBLOCK: 'wu:unblock',
-  WU_RELEASE: 'wu:release',
-  WU_RECOVER: 'wu:recover',
-  WU_REPAIR: 'wu:repair',
-  GATES: 'gates',
-} as const;
-
-type LifecycleToolName = (typeof LIFECYCLE_TOOLS)[keyof typeof LIFECYCLE_TOOLS];
-
-const LIFECYCLE_TOOL_ERROR_CODES: Record<LifecycleToolName, string> = {
-  'wu:status': 'WU_STATUS_ERROR',
-  'wu:create': 'WU_CREATE_ERROR',
-  'wu:claim': 'WU_CLAIM_ERROR',
-  'wu:prep': 'WU_PREP_ERROR',
-  'wu:done': 'WU_DONE_ERROR',
-  'wu:sandbox': 'WU_SANDBOX_ERROR',
-  'wu:prune': 'WU_PRUNE_ERROR',
-  'wu:delete': 'WU_DELETE_ERROR',
-  'wu:cleanup': 'WU_CLEANUP_ERROR',
-  'wu:unlock-lane': 'WU_UNLOCK_LANE_ERROR',
-  'wu:brief': 'WU_BRIEF_ERROR',
-  'wu:delegate': 'WU_DELEGATE_ERROR',
-  'wu:deps': 'WU_DEPS_ERROR',
-  'wu:edit': 'WU_EDIT_ERROR',
-  'wu:proto': 'WU_PROTO_ERROR',
-  'wu:preflight': 'WU_PREFLIGHT_ERROR',
-  'wu:validate': 'WU_VALIDATE_ERROR',
-  'wu:block': 'WU_BLOCK_ERROR',
-  'wu:unblock': 'WU_UNBLOCK_ERROR',
-  'wu:release': 'WU_RELEASE_ERROR',
-  'wu:recover': 'WU_RECOVER_ERROR',
-  'wu:repair': 'WU_REPAIR_ERROR',
-  gates: 'GATES_ERROR',
-};
-
-interface LifecycleToolCommandSpec {
-  command: (typeof RUNTIME_CLI_COMMANDS)[keyof typeof RUNTIME_CLI_COMMANDS];
-}
-
-const LIFECYCLE_TOOL_COMMAND_SPECS: Record<LifecycleToolName, LifecycleToolCommandSpec> = {
-  'wu:status': { command: RUNTIME_CLI_COMMANDS.WU_STATUS },
-  'wu:create': { command: RUNTIME_CLI_COMMANDS.WU_CREATE },
-  'wu:claim': { command: RUNTIME_CLI_COMMANDS.WU_CLAIM },
-  'wu:prep': { command: RUNTIME_CLI_COMMANDS.WU_PREP },
-  'wu:done': { command: RUNTIME_CLI_COMMANDS.WU_DONE },
-  'wu:sandbox': { command: RUNTIME_CLI_COMMANDS.WU_SANDBOX },
-  'wu:prune': { command: RUNTIME_CLI_COMMANDS.WU_PRUNE },
-  'wu:delete': { command: RUNTIME_CLI_COMMANDS.WU_DELETE },
-  'wu:cleanup': { command: RUNTIME_CLI_COMMANDS.WU_CLEANUP },
-  'wu:unlock-lane': { command: RUNTIME_CLI_COMMANDS.WU_UNLOCK_LANE },
-  'wu:brief': { command: RUNTIME_CLI_COMMANDS.WU_BRIEF },
-  'wu:delegate': { command: RUNTIME_CLI_COMMANDS.WU_DELEGATE },
-  'wu:deps': { command: RUNTIME_CLI_COMMANDS.WU_DEPS },
-  'wu:edit': { command: RUNTIME_CLI_COMMANDS.WU_EDIT },
-  'wu:proto': { command: RUNTIME_CLI_COMMANDS.WU_PROTO },
-  'wu:preflight': { command: RUNTIME_CLI_COMMANDS.WU_PREFLIGHT },
-  'wu:validate': { command: RUNTIME_CLI_COMMANDS.WU_VALIDATE },
-  'wu:block': { command: RUNTIME_CLI_COMMANDS.WU_BLOCK },
-  'wu:unblock': { command: RUNTIME_CLI_COMMANDS.WU_UNBLOCK },
-  'wu:release': { command: RUNTIME_CLI_COMMANDS.WU_RELEASE },
-  'wu:recover': { command: RUNTIME_CLI_COMMANDS.WU_RECOVER },
-  'wu:repair': { command: RUNTIME_CLI_COMMANDS.WU_REPAIR },
-  gates: { command: RUNTIME_CLI_COMMANDS.GATES },
-};
-
-const MISSING_PARAMETER_MESSAGES = {
-  ID_REQUIRED: 'id is required',
-  COMMAND_REQUIRED: 'command is required',
-  PARENT_WU_REQUIRED: 'parent_wu is required',
-  LANE_REQUIRED: 'lane is required',
-  TITLE_REQUIRED: 'title is required',
-  REASON_REQUIRED: 'reason is required',
-  SANDBOX_COMMAND_REQUIRED: 'sandbox_command is required when sandbox=true',
-} as const;
-
-const LIFECYCLE_FLAGS = {
-  DESCRIPTION: '--description',
-  CODE_PATHS: '--code-paths',
-} as const;
-
-interface CommandExecutionResult {
-  ok: boolean;
-  status: number;
-  stdout: string;
-  stderr: string;
-  executionError?: string;
-}
-
-interface RunOptions {
-  parseJson?: boolean;
-}
-
-function toRecord(input: unknown): Record<string, unknown> {
-  if (input && typeof input === 'object') {
-    return input as Record<string, unknown>;
-  }
-  return {};
-}
-
-function toStringValue(value: unknown): string | null {
-  if (typeof value !== 'string') {
-    return null;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : null;
-}
-
-function toStringArray(value: unknown): string[] {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value
-    .map((entry) => toStringValue(entry))
-    .filter((entry): entry is string => entry !== null);
-}
-
-function toIntegerString(value: unknown): string | null {
-  if (typeof value === 'number' && Number.isFinite(value)) {
-    return String(Math.trunc(value));
-  }
-  if (typeof value === 'string') {
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : null;
-  }
-  return null;
-}
-
-async function runLifecycleCommand(
-  toolName: LifecycleToolName,
-  args: string[],
-): Promise<CommandExecutionResult> {
-  const spec = LIFECYCLE_TOOL_COMMAND_SPECS[toolName];
-  return runtimeCliAdapter.run(spec.command, args);
-}
-
-function createMissingParameterOutput(message: string): ToolOutput {
-  return {
-    success: false,
-    error: {
-      code: 'MISSING_PARAMETER',
-      message,
-    },
-  };
-}
-
-function createFailureOutput(
-  toolName: LifecycleToolName,
-  execution: CommandExecutionResult,
-): ToolOutput {
-  const stderrMessage = execution.stderr.trim();
-  const stdoutMessage = execution.stdout.trim();
-  const message =
-    execution.executionError ??
-    (stderrMessage.length > 0
-      ? stderrMessage
-      : stdoutMessage.length > 0
-        ? stdoutMessage
-        : `${toolName} failed`);
-  return {
-    success: false,
-    error: {
-      code: LIFECYCLE_TOOL_ERROR_CODES[toolName],
-      message,
-      details: {
-        exit_code: execution.status,
-        stdout: execution.stdout,
-        stderr: execution.stderr,
-      },
-    },
-  };
-}
-
-function parseJsonOutput(stdout: string): unknown | null {
-  const trimmed = stdout.trim();
-  if (trimmed.length === 0) {
-    return null;
-  }
-  try {
-    return JSON.parse(trimmed) as unknown;
-  } catch {
-    return null;
-  }
-}
-
-function createSuccessOutput(
-  toolName: LifecycleToolName,
-  execution: CommandExecutionResult,
-  options: RunOptions,
-): ToolOutput {
-  const parsedJson = options.parseJson ? parseJsonOutput(execution.stdout) : null;
-  if (parsedJson !== null) {
-    return {
-      success: true,
-      data: parsedJson,
-    };
-  }
-
-  const message = execution.stdout.trim().length > 0 ? execution.stdout.trim() : `${toolName} ran`;
-  return {
-    success: true,
-    data: {
-      message,
-    },
-  };
-}
-
-async function executeLifecycleTool(
-  toolName: LifecycleToolName,
-  args: string[],
-  options: RunOptions = {},
-): Promise<ToolOutput> {
-  const execution = await runLifecycleCommand(toolName, args);
-  if (!execution.ok) {
-    return createFailureOutput(toolName, execution);
-  }
-  return createSuccessOutput(toolName, execution, options);
-}
-
-function pushRepeatedFlag(args: string[], flag: string, values: string[]): void {
-  for (const value of values) {
-    args.push(flag, value);
-  }
-}
-
-function appendWuPromptArgs(parsed: Record<string, unknown>, args: string[]): void {
-  const client = toStringValue(parsed.client);
-  if (client) {
-    args.push('--client', client);
-  }
-  if (parsed.thinking === true) {
-    args.push('--thinking');
-  }
-  const budget = toIntegerString(parsed.budget);
-  if (budget) {
-    args.push('--budget', budget);
-  }
-  const parentWu = toStringValue(parsed.parent_wu);
-  if (parentWu) {
-    args.push('--parent-wu', parentWu);
-  }
-  if (parsed.no_context === true) {
-    args.push('--no-context');
-  }
-}
-
-export async function wuCreateTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const lane = toStringValue(parsed.lane);
-  const title = toStringValue(parsed.title);
-  if (!lane) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.LANE_REQUIRED);
-  }
-  if (!title) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.TITLE_REQUIRED);
-  }
-
-  const args: string[] = ['--lane', lane, '--title', title];
-  const id = toStringValue(parsed.id);
-  if (id) {
-    args.push('--id', id);
-  }
-  const description = toStringValue(parsed.description);
-  if (description) {
-    args.push(LIFECYCLE_FLAGS.DESCRIPTION, description);
-  }
-  pushRepeatedFlag(args, '--acceptance', toStringArray(parsed.acceptance));
-  pushRepeatedFlag(args, LIFECYCLE_FLAGS.CODE_PATHS, toStringArray(parsed.code_paths));
-  const exposure = toStringValue(parsed.exposure);
-  if (exposure) {
-    args.push('--exposure', exposure);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_CREATE, args);
-}
-
-export async function wuClaimTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  const lane = toStringValue(parsed.lane);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-  if (!lane) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.LANE_REQUIRED);
-  }
-
-  const args: string[] = ['--id', id, '--lane', lane];
-  if (parsed.cloud === true) {
-    args.push('--cloud');
-  }
-  if (parsed.branch_only === true) {
-    args.push('--branch-only');
-  }
-  if (parsed.pr_mode === true) {
-    args.push('--pr-mode');
-  }
-  if (parsed.sandbox === true) {
-    const sandboxCommand = toStringArray(parsed.sandbox_command);
-    if (sandboxCommand.length === 0) {
-      return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.SANDBOX_COMMAND_REQUIRED);
-    }
-    args.push('--sandbox', '--', ...sandboxCommand);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_CLAIM, args);
-}
-
-export async function wuPrepTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args = ['--id', id];
-  if (parsed.docs_only === true) {
-    args.push('--docs-only');
-  }
-  if (parsed.full_tests === true) {
-    args.push('--full-tests');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_PREP, args);
-}
-
-export async function wuDoneTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args = ['--id', id];
-  if (parsed.skip_gates === true) {
-    args.push('--skip-gates');
-    const reason = toStringValue(parsed.reason);
-    if (reason) {
-      args.push('--reason', reason);
-    }
-    const fixWu = toStringValue(parsed.fix_wu);
-    if (fixWu) {
-      args.push('--fix-wu', fixWu);
-    }
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_DONE, args);
-}
-
-export async function wuSandboxTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const command = toStringArray(parsed.command);
-  if (command.length === 0) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.COMMAND_REQUIRED);
-  }
-
-  const args: string[] = ['--id', id];
-  const worktree = toStringValue(parsed.worktree);
-  if (worktree) {
-    args.push('--worktree', worktree);
-  }
-  args.push('--', ...command);
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_SANDBOX, args);
-}
-
-export async function wuPruneTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const args: string[] = [];
-  if (parsed.execute === true) {
-    args.push('--execute');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_PRUNE, args);
-}
-
-export async function wuDeleteTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  const batch = toStringValue(parsed.batch);
-  if (!id && !batch) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args: string[] = [];
-  if (id) {
-    args.push('--id', id);
-  }
-  if (parsed.dry_run === true) {
-    args.push('--dry-run');
-  }
-  if (batch) {
-    args.push('--batch', batch);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_DELETE, args);
-}
-
-export async function wuCleanupTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args: string[] = ['--id', id];
-  if (parsed.artifacts === true) {
-    args.push('--artifacts');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_CLEANUP, args);
-}
-
-export async function wuUnlockLaneTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const listMode = parsed.list === true;
-  const lane = toStringValue(parsed.lane);
-  if (!listMode && !lane) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.LANE_REQUIRED);
-  }
-
-  const args: string[] = [];
-  if (lane) {
-    args.push('--lane', lane);
-  }
-  const reason = toStringValue(parsed.reason);
-  if (reason) {
-    args.push('--reason', reason);
-  }
-  if (parsed.force === true) {
-    args.push('--force');
-  }
-  if (listMode) {
-    args.push('--list');
-  }
-  if (parsed.status === true) {
-    args.push('--status');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_UNLOCK_LANE, args);
-}
-
-export async function wuProtoTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const lane = toStringValue(parsed.lane);
-  const title = toStringValue(parsed.title);
-  if (!lane) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.LANE_REQUIRED);
-  }
-  if (!title) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.TITLE_REQUIRED);
-  }
-
-  const args: string[] = ['--lane', lane, '--title', title];
-  const description = toStringValue(parsed.description);
-  if (description) {
-    args.push(LIFECYCLE_FLAGS.DESCRIPTION, description);
-  }
-  pushRepeatedFlag(args, LIFECYCLE_FLAGS.CODE_PATHS, toStringArray(parsed.code_paths));
-  const labels = toStringArray(parsed.labels);
-  if (labels.length > 0) {
-    args.push('--labels', labels.join(','));
-  }
-  const assignedTo = toStringValue(parsed.assigned_to);
-  if (assignedTo) {
-    args.push('--assigned-to', assignedTo);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_PROTO, args);
-}
-
-export async function wuBriefTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args: string[] = ['--id', id];
-  appendWuPromptArgs(parsed, args);
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_BRIEF, args);
-}
-
-export async function wuDelegateTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  const parentWu = toStringValue(parsed.parent_wu);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-  if (!parentWu) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.PARENT_WU_REQUIRED);
-  }
-
-  const args: string[] = ['--id', id];
-  appendWuPromptArgs(parsed, args);
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_DELEGATE, args);
-}
-
-export async function wuDepsTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args: string[] = ['--id', id];
-  const format = toStringValue(parsed.format);
-  if (format) {
-    args.push('--format', format);
-  }
-  const depth = toIntegerString(parsed.depth);
-  if (depth) {
-    args.push('--depth', depth);
-  }
-  const direction = toStringValue(parsed.direction);
-  if (direction) {
-    args.push('--direction', direction);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_DEPS, args);
-}
-
-export async function wuEditTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args: string[] = ['--id', id];
-  const description = toStringValue(parsed.description);
-  if (description) {
-    args.push(LIFECYCLE_FLAGS.DESCRIPTION, description);
-  }
-  pushRepeatedFlag(args, '--acceptance', toStringArray(parsed.acceptance));
-  const notes = toStringValue(parsed.notes);
-  if (notes) {
-    args.push('--notes', notes);
-  }
-  pushRepeatedFlag(args, LIFECYCLE_FLAGS.CODE_PATHS, toStringArray(parsed.code_paths));
-  const lane = toStringValue(parsed.lane);
-  if (lane) {
-    args.push('--lane', lane);
-  }
-  const priority = toStringValue(parsed.priority);
-  if (priority) {
-    args.push('--priority', priority);
-  }
-  const initiative = toStringValue(parsed.initiative);
-  if (initiative) {
-    args.push('--initiative', initiative);
-  }
-  const phase = toIntegerString(parsed.phase);
-  if (phase) {
-    args.push('--phase', phase);
-  }
-  if (parsed.no_strict === true) {
-    args.push('--no-strict');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_EDIT, args);
-}
-
-export async function wuBlockTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  const reason = toStringValue(parsed.reason);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-  if (!reason) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.REASON_REQUIRED);
-  }
-
-  const args = ['--id', id, '--reason', reason];
-  if (parsed.remove_worktree === true) {
-    args.push('--remove-worktree');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_BLOCK, args);
-}
-
-export async function wuUnblockTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args = ['--id', id];
-  const reason = toStringValue(parsed.reason);
-  if (reason) {
-    args.push('--reason', reason);
-  }
-  if (parsed.create_worktree === true) {
-    args.push('--create-worktree');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_UNBLOCK, args);
-}
-
-export async function wuReleaseTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args = ['--id', id];
-  const reason = toStringValue(parsed.reason);
-  if (reason) {
-    args.push('--reason', reason);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_RELEASE, args);
-}
-
-export async function wuRecoverTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args = ['--id', id];
-  const action = toStringValue(parsed.action);
-  if (action) {
-    args.push('--action', action);
-  }
-  if (parsed.force === true) {
-    args.push('--force');
-  }
-  if (parsed.json === true) {
-    args.push('--json');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_RECOVER, args, {
-    parseJson: parsed.json === true,
-  });
-}
-
-export async function wuRepairTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-
-  const args: string[] = [];
-  const id = toStringValue(parsed.id);
-  if (id) {
-    args.push('--id', id);
-  }
-  if (parsed.check === true) {
-    args.push('--check');
-  }
-  if (parsed.all === true) {
-    args.push('--all');
-  }
-  if (parsed.claim === true) {
-    args.push('--claim');
-  }
-  if (parsed.admin === true) {
-    args.push('--admin');
-  }
-  if (parsed.repair_state === true) {
-    args.push('--repair-state');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_REPAIR, args);
-}
-
-/**
- * WU-2833 (INIT-062 WU-G): privileged wu:repair variant registered as a
- * distinct pack tool (wu:repair:admin) so cloud-team phone UX can expose
- * admin recovery behind a remote_mutation approval gate without widening
- * the default wu:repair surface. Forces `--admin` on every invocation.
- */
-export async function wuRepairAdminTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-
-  const args: string[] = ['--admin'];
-  const id = toStringValue(parsed.id);
-  if (id) {
-    args.push('--id', id);
-  }
-  if (parsed.check === true) {
-    args.push('--check');
-  }
-  if (parsed.all === true) {
-    args.push('--all');
-  }
-  if (parsed.claim === true) {
-    args.push('--claim');
-  }
-  if (parsed.repair_state === true) {
-    args.push('--repair-state');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_REPAIR, args);
-}
-
-export async function wuStatusTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_STATUS, ['--id', id, '--json'], {
-    parseJson: true,
-  });
-}
-
-export async function wuPreflightTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args = ['--id', id];
-  const worktree = toStringValue(parsed.worktree);
-  if (worktree) {
-    args.push('--worktree', worktree);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_PREFLIGHT, args);
-}
-
-export async function wuValidateTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const id = toStringValue(parsed.id);
-  if (!id) {
-    return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.ID_REQUIRED);
-  }
-
-  const args = ['--id', id];
-  if (parsed.no_strict === true) {
-    args.push('--no-strict');
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_VALIDATE, args);
-}
-
-export async function gatesTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  const args: string[] = [];
-  if (parsed.docs_only === true) {
-    args.push('--docs-only');
-  }
-  if (parsed.full_lint === true) {
-    args.push('--full-lint');
-  }
-  const coverageMode = toStringValue(parsed.coverage_mode);
-  if (coverageMode) {
-    args.push('--coverage-mode', coverageMode);
-  }
-
-  return executeLifecycleTool(LIFECYCLE_TOOLS.GATES, args);
-}
-
-/**
- * WU-2729 (INIT-060 Phase 2, ADR-013 §3 tool exposure): gates:docs is the
- * remote-callable tool that always runs docs-only gates. It exists as a
- * distinct manifest entry so the conductor scope grammar
- * (`tool:gates:docs`) can authorize it independently of the permissive
- * `gates` handler. Input `full_lint` and `coverage_mode` are forwarded
- * unchanged; `docs_only` is forced to true regardless of the caller's
- * input so there is no way to mis-dispatch a full gate run under this
- * tool name.
- */
-export async function gatesDocsTool(input: unknown): Promise<ToolOutput> {
-  const parsed = toRecord(input);
-  return gatesTool({
-    ...parsed,
-    docs_only: true,
-  });
-}