svn_status

Instructions

Implementation Reference

• tools/svn-service.ts:161-201 (handler)

  Core handler function that executes 'svn status' command (with optional --show-updates for remote status), parses the output using parseStatusOutput, and returns structured SvnStatus[]

  async getStatus(path?: string, showAll: boolean = false): Promise<SvnResponse<SvnStatus[]>> {
    try {
      const args = ['status'];
      
      if (path) {
        if (!validatePath(path)) {
          throw new SvnError(`Invalid path: ${path}`);
        }
        args.push(normalizePath(path));
      }
  
      let response;
      
      // Si showAll es true, intentar primero con --show-updates
      if (showAll) {
        try {
          const argsWithUpdates = [...args, '--show-updates'];
          response = await executeSvnCommand(this.config, argsWithUpdates);
        } catch (error: any) {
          // Si falla con --show-updates, intentar sin él
          console.warn(`Warning: --show-updates failed, falling back to local status only: ${error.message}`);
          response = await executeSvnCommand(this.config, args);
        }
      } else {
        response = await executeSvnCommand(this.config, args);
      }
  
      const statusList = parseStatusOutput(cleanOutput(response.data as string));
  
      return {
        success: true,
        data: statusList,
        command: response.command,
        workingDirectory: response.workingDirectory,
        executionTime: response.executionTime
      };
  
    } catch (error: any) {
      this.handleSvnError(error, 'get SVN status');
    }
  }

• index.ts:152-201 (registration)

  MCP server registration of 'svn_status' tool, including Zod input schema (path?: string, showAll?: boolean) and wrapper handler that calls SvnService.getStatus and formats response with icons

  server.tool(
    "svn_status",
    "Ver el estado de archivos en el working copy",
    {
      path: z.string().optional().describe("Ruta específica a consultar"),
      showAll: z.boolean().optional().default(false).describe("Mostrar estado remoto también")
    },
    async (args) => {
      try {
        const result = await getSvnService().getStatus(args.path, args.showAll);
        const statusList = result.data!;
        
        if (statusList.length === 0) {
          return {
            content: [{ type: "text", text: "✅ **No hay cambios en el working copy**" }],
          };
        }
  
               const statusText = `📊 **Estado SVN** (${statusList.length} elementos)\n\n` +
           statusList.map(status => {
             const statusIcon: {[key: string]: string} = {
               'added': '➕',
               'deleted': '➖',
               'modified': '✏️',
               'replaced': '🔄',
               'merged': '🔀',
               'conflicted': '⚠️',
               'ignored': '🙈',
               'none': '⚪',
               'normal': '✅',
               'external': '🔗',
               'incomplete': '⏸️',
               'unversioned': '❓',
               'missing': '❌'
             };
             
             return `${statusIcon[status.status] || '📄'} **${status.status.toUpperCase()}** - ${status.path}`;
           }).join('\n') +
           `\n\n**Tiempo de Ejecución:** ${formatDuration(result.executionTime || 0)}`;
  
         return {
           content: [{ type: "text", text: statusText }],
         };
      } catch (error: any) {
        return {
          content: [{ type: "text", text: `❌ **Error:** ${error.message}` }],
        };
      }
    }
  );

• index.ts:155-158 (schema)

  Zod input schema validation for svn_status tool parameters

  {
    path: z.string().optional().describe("Ruta específica a consultar"),
    showAll: z.boolean().optional().default(false).describe("Mostrar estado remoto también")
  },

• common/types.ts:50-57 (schema)

  TypeScript interface defining the structure of SVN status entries returned by the tool

  export interface SvnStatus {
    path: string;
    status: 'unversioned' | 'added' | 'deleted' | 'modified' | 'replaced' | 'merged' | 'conflicted' | 'ignored' | 'none' | 'normal' | 'external' | 'incomplete';
    revision?: number;
    changedRev?: number;
    changedAuthor?: string;
    changedDate?: string;
  }

• common/utils.ts:281-301 (helper)

  Utility function to parse raw 'svn status' command output into array of SvnStatus objects using SVN_STATUS_CODES mapping

  export function parseStatusOutput(output: string): SvnStatus[] {
    const lines = output.split('\n').filter(line => line.trim());
    const statusList: SvnStatus[] = [];
    
    for (const line of lines) {
      if (line.length < 8) continue;
      
      const statusCode = line[0];
      const propStatusCode = line[1];
      const path = line.substring(8).trim();
      
      const status: SvnStatus = {
        path,
        status: (SVN_STATUS_CODES as any)[statusCode] || 'unknown'
      };
      
      statusList.push(status);
    }
    
    return statusList;
  }