VSFileTools

Een VSCode extensie met file management tools en AI-powered Git documentatie prompts.

Features

Deze extensie biedt de volgende functionaliteit:

📁 File Management Tools

Merge Files: Voeg meerdere bestanden samen in één uitvoerbestand
List Files: Genereer een lijst van alle bestanden in een map
Count Lines per File: Tel het aantal regels per bestand
Insert Filename: Voeg de relatieve bestandsnaam toe aan het begin van bestanden
Generate Port Assignments: Genereer deterministische poorten voor je project
Generate Secret Keys: Genereer veilige secret keys voor .env bestanden

🤖 AI-Powered Git Documentation (NEW!)

18 Specialized AI Prompts voor comprehensive Git project documentation
4 Chat Participants georganiseerd per workflow:
- @vsfiletools-analysis — Strategic analysis & architecture (Group A)
- @vsfiletools-daily — Daily workflow operations (Group B)
- @vsfiletools-export — Feature bundling & export (Group C)
- @vsfiletools-governance — Governance & meta-level tracking (Group D)
Execution Tracking: Automatische logging in docs/meta/PROMPT_EXECUTION_LEDGER.json
Interactive Sidebar Menu: Visual overzicht van alle prompts met status indicators
Git Context Integration: Automatisch verzamelen van branch, status en commit info

🎯 Gebruik

File Management Tools

Rechtsklik op een bestand of map in de Explorer en kies een optie uit het VSFileTools submenu.

AI Prompts via Copilot Chat

Open Copilot Chat (Ctrl+Alt+I) en gebruik de chat participants:

@vsfiletools-daily /B1 Add new feature X to roadmap
@vsfiletools-analysis /A1 Analyze project structure
@vsfiletools-governance /D4 Show execution history

Gebruik /help om alle beschikbare prompts in een groep te zien:

@vsfiletools-daily /help

Open Explorer (Ctrl+Shift+E)
Find "VSFileTools AI Prompts" panel onderaan
Click op een prompt om deze uit te voeren

Port Calculator

De Port Calculator feature genereert deterministische poorten voor je project op basis van de projectnaam:

Rechtsklik in de Explorer en selecteer VSFileTools > Generate Port Assignments
De extensie genereert poorten voor:
- Frontend - Voor web applicaties en UI
- Backend - Voor server/API backend
- API - Voor REST/GraphQL endpoints
- Docs - Voor documentatie server

De gegenereerde poorten worden:

Toegevoegd aan .env (indien het bestand bestaat)
Toegevoegd aan of aangemaakt in .env.example
Gedocumenteerd in .github/copilot-instructions.md (wordt aangemaakt indien niet aanwezig)

Voordelen:

Consistent dezelfde poorten per project
Vermijdt veelgebruikte poorten (3000, 5432, 8080, etc.)
Geen port conflicts tussen projecten
Automatische documentatie voor team members en Copilot

📚 AI Prompts Reference

De extensie bevat 17 gespecialiseerde AI prompts verdeeld over 4 groepen. Alle prompts zijn ontworpen om comprehensive Git-based documentatie te genereren voor je project.

Group A: Strategic Analysis & Architecture (@vsfiletools-analysis)

A1 - Project Mapping (Quick) (/A1)

Snelle project overview met essentiële architectuur
Top 3-5 risico's en quick wins
Compacte output (max 2000 woorden)
💡 Start hier voor eerste inzicht

A1x - Project Mapping (Extended) (/A1x)

Uitgebreide analyse met 10 gedetailleerde documenten
Volledige tech stack verdieping (Next.js/Python/clasp)
Complete module, API, en data mapping
Gebruik na A1 voor deep dive

A2 - Core Architecture (/A2)

Documenteert de core technical architecture
Analyseert design patterns en beslissingen
Output: docs/ARCHITECTURE.md

A3 - Development Guide (/A3)

Creëert een comprehensive development guide
Setup instructies, workflows, best practices
Output: docs/DEVELOPMENT.md

A4 - Strategic Roadmap (/A4)

Bouwt een strategic product roadmap
Features, milestones, technical debt tracking
Output: docs/ROADMAP.md

Group B: Daily Workflow Operations (@vsfiletools-daily)

B1 - Feature Planning (/B1)

Plan nieuwe features met impact analysis
Output: docs/features/FEATURE_[name]_PLANNING.md

B2 - Sprint Planning (/B2)

Sync project roadmap voor nieuwe sprint
Analyseer current state, plan next steps
Output: Updates docs/ROADMAP.md

B3 - Cross-Branch Sync (/B3)

Sync planning tussen branches
Track parallel development streams
Output: Updates roadmap met sync info

B4 - Feature Implementation Report (/B4)

Documenteer completed feature implementation
Inclusief changes, testing, deployment notes
Output: docs/features/FEATURE_[name]_IMPLEMENTATION.md

B5 - Session Log (/B5)

Creëer gedetailleerde session development log
Track beslissingen, changes, context
Output: docs/sessions/SESSION_[timestamp].md

B6 - Cross-Reference Update (/B6)

Synchroniseer cross-references tussen documenten
Ensure consistency across documentation
Updates: Multiple docs met reference links

B7 - Feature Manifest Update (/B7)

Update master feature manifest
Track alle features met status en metadata
Output: docs/FEATURE_MANIFEST.md

B8 - Issue Resolution (/B8)

Document bug fixes en issue resolutions
Root cause analysis en solution details
Output: docs/issues/ISSUE_[id]_RESOLUTION.md

Group C: Export & Packaging (@vsfiletools-export)

C1 - Feature Bundle Export (/C1)

Bundel een complete feature voor export/reuse
Inclusief code, docs, config, tests
Output: Gestructureerde export in features-export/

Group D: Governance & Meta-Level Tracking (@vsfiletools-governance)

D1 - Validation Report (/D1)

Valideer alle documentatie op consistency
Check broken links, outdated info, gaps
Output: docs/meta/VALIDATION_REPORT.md

D2 - Sync Activity Report (/D2)

Genereer cross-branch sync activity report
Track merge patterns, conflicts, resolution
Output: docs/meta/SYNC_ACTIVITY_REPORT.md

D3 - Governance Audit (/D3)

Complete governance en compliance audit
Review documentation standards, completeness
Output: docs/meta/GOVERNANCE_AUDIT.md

D4 - Execution History (/D4)

Show prompt execution history met analytics
Track welke prompts zijn gebruikt wanneer
Output: Console output + docs/meta/PROMPT_EXECUTION_LEDGER.json

💡 Gebruik Tips

Via Chat:

@vsfiletools-analysis /A1
@vsfiletools-daily /B2 Planning for Q2 sprint
@vsfiletools-governance /D1

Via Sidebar:

Open Explorer (Ctrl+Shift+E)
Scroll naar "VSFileTools AI Prompts" panel
Click op een prompt naam
Prompt wordt uitgevoerd in Copilot Chat

Execution Tracking: Alle prompt executions worden automatisch gelogd in docs/meta/PROMPT_EXECUTION_LEDGER.json met:

Timestamp
Branch name
Prompt ID en user input
Generated output paths

Context Integration: Prompts verzamelen automatisch:

Current Git branch
Working directory status
Active file information
Project structure details

Deze context wordt meegestuurd naar het language model voor accurate en project-specifieke responses.

Configuratie

De extensie kan worden geconfigureerd via VS Code instellingen of via een vsfiletools.config.json bestand in de root van je project.

Algemene Configuratie

{
  "vsFileTools.excludedDirs": [".git", "node_modules", ".next"],
  "vsFileTools.excludedFiles": [],
  "vsFileTools.excludedExtensions": [".log"]
}

Count Lines per File - Specifieke Configuratie

De Count Lines per File functie heeft specifieke configuratie-opties:

vsFileTools.countLines.includedExtensions

Standaard waarde: Een uitgebreide lijst met veel voorkomende code-extensies zoals .js, .ts, .py, .java, .cpp, .html, .css, .md, etc.

Beschrijving: Alleen bestanden met deze extensies worden meegenomen bij het tellen van regels. Alle andere extensies worden genegeerd.

Voorbeeld configuratie:

{
  "vsFileTools.countLines.includedExtensions": [
    ".js",
    ".ts",
    ".tsx",
    ".jsx",
    ".py",
    ".md"
  ]
}

vsFileTools.countLines.excludedDirs

Standaard waarde: [".git", "node_modules", ".next", "dist", "build", "out", ".vscode", ".idea", "coverage", ".pytest_cache", "__pycache__", "venv", ".env", "target", "bin", "obj"]

Beschrijving: Deze directories worden overgeslagen bij het scannen naar bestanden.

vsFileTools.countLines.showSummary

Standaard waarde: true

Beschrijving: Toont een uitgebreide samenvatting bovenaan het rapport met:

Totaal aantal bestanden
Totaal aantal regels code
Gemiddeld aantal regels per bestand
Gevonden extensies
Uitgesloten directories en extensies
Lijst van geïncludeerde extensies voor de scan

Voorbeeld output met samenvatting:

============================================================
  COUNT LINES PER FILE - SAMENVATTING
============================================================

Totaal aantal bestanden: 42
Totaal aantal regels:    15234
Gemiddeld per bestand:   363

Gevonden extensies: .css, .js, .json, .md, .ts, .tsx

Uitgesloten directories: .git, node_modules, dist, build
Uitgesloten extensies:   .log

Geïncludeerde extensies voor scan:
.js, .ts, .tsx, .jsx, .py, .java, .c, .cpp, .h, .cs, .php, ...

============================================================

  1523 regels : src/extension.ts
   842 regels : src/portCalculator.ts
   ...

Config File Alternative

Je kunt ook een vsfiletools.config.json bestand maken in de root van je project:

{
  "excludedDirs": [".git", "node_modules", ".next", "dist"],
  "excludedFiles": ["temp.txt"],
  "excludedExtensions": [".log", ".tmp"]
}

Prioriteit: VS Code settings hebben voorrang op het config bestand.

Installatie

Via VS Code Marketplace

Beschikbaar via VSCode Marketplace: [https://marketplace.visualstudio.com/items?itemName=BrechtParmentier.vs-file-tools]

Development Setup

Dit project gebruikt Volta voor Node.js en pnpm versie management.

Automatische Setup (aanbevolen)

./setup-volta.sh

Dit script:

Installeert Volta (indien nog niet geïnstalleerd)
Pinnen Node.js 22.15.0 en pnpm 10.23.0 voor dit project
Biedt optioneel aan om Ubuntu's Node.js te verwijderen

Handmatige Setup

Als je Volta al hebt geïnstalleerd:

# Installeer dependencies
pnpm install

# Compileer de extensie
pnpm run compile

# Start development mode
pnpm run watch

Versies:

Node.js: 22.15.0 (managed by Volta)
pnpm: 10.23.0 (managed by Volta)

Deze versies worden automatisch gebruikt wanneer je in deze projectmap werkt.

Info

Auteur: Brecht Parmentier Repository: [https://github.com/brechtparmentier/vscodeExt_combineFilesToOne.git]

VSFileTools

BrechtParmentier

VSFileTools

Features

📁 File Management Tools

🤖 AI-Powered Git Documentation (NEW!)

🎯 Gebruik

File Management Tools

AI Prompts via Copilot Chat

AI Prompts via Sidebar

Port Calculator

📚 AI Prompts Reference

Group A: Strategic Analysis & Architecture (@vsfiletools-analysis)

Group B: Daily Workflow Operations (@vsfiletools-daily)

Group C: Export & Packaging (@vsfiletools-export)

Group D: Governance & Meta-Level Tracking (@vsfiletools-governance)

💡 Gebruik Tips

Configuratie

Algemene Configuratie

Count Lines per File - Specifieke Configuratie

vsFileTools.countLines.includedExtensions

vsFileTools.countLines.excludedDirs

vsFileTools.countLines.showSummary

Config File Alternative

Installatie

Via VS Code Marketplace

Development Setup

Automatische Setup (aanbevolen)

Handmatige Setup

Info