Atualizar Índice de Arquivos Markdown

Atualize o arquivo markdown ${file} com um índice/tabela de arquivos da pasta ${input:folder}.

Processo

1. Escanear: Leia o arquivo markdown alvo ${file} para entender a estrutura existente.
2. Descobrir: Liste todos os arquivos na pasta especificada ${input:folder} que correspondem ao padrão ${input:pattern}.
3. Analisar: Identifique se uma seção de tabela/índice existente precisa ser atualizada ou se uma nova estrutura deve ser criada.
4. Estruturar: Gere o formato de tabela/lista apropriado com base nos tipos de arquivo e no conteúdo existente.
5. Atualizar: Substitua a seção existente ou adicione uma nova seção com o índice de arquivos.
6. Validar: Garanta que a sintaxe markdown seja válida e que a formatação seja consistente.

Análise de Arquivos

Para cada arquivo descoberto, extraia:

• Nome: Nome do arquivo com ou sem extensão, dependendo do contexto.
• Tipo: Extensão do arquivo e categoria (por exemplo, .md, .js, .py).
• Descrição: Comentário da primeira linha, cabeçalho ou propósito inferido.
• Tamanho: Tamanho do arquivo para referência (opcional).
• Modificado: Data da última modificação (opcional).

Opções de Estrutura de Tabela

Escolha o formato com base nos tipos de arquivo e no conteúdo existente:

Opção 1: Lista Simples

## Files in ${folder}

- [filename.ext](path/to/filename.ext) - Description
- [filename2.ext](path/to/filename2.ext) - Description

Opção 2: Tabela Detalhada

| File | Type | Description |
|------|------|-------------|
| [filename.ext](path/to/filename.ext) | Extension | Description |
| [filename2.ext](path/to/filename2.ext) | Extension | Description |

Opção 3: Seções Categorizadas

Agrupe arquivos por tipo/categoria com seções ou sub-tabelas separadas.

Estratégia de Atualização

• 🔄 Atualizar existente: Se a seção de tabela/índice existir, substitua o conteúdo preservando a estrutura.
• ➕ Adicionar novo: Se não houver seção existente, crie uma nova seção usando o formato mais adequado.
• 📋 Preservar: Mantenha a formatação markdown existente, níveis de cabeçalho e fluxo do documento.
• 🔗 Links: Use caminhos relativos para links de arquivos dentro do repositório.

Identificação de Seção

Procure por seções existentes com estes padrões:

• Cabeçalhos contendo: "índice", "arquivos", "conteúdo", "diretório", "lista".
• Tabelas com colunas relacionadas a arquivos.
• Listas com links de arquivos.
• Comentários HTML marcando seções de índice de arquivos.

Requisitos

• Preservar a estrutura e formatação markdown existentes.
• Usar caminhos relativos para links de arquivos.
• Incluir descrições de arquivos quando disponíveis.
• Ordenar arquivos alfabeticamente por padrão.
• Lidar com caracteres especiais em nomes de arquivos.
• Validar toda a sintaxe markdown gerada.