jdi-cli 0.1.0

package/bin/jdi.js

@@ -0,0 +1,460 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawn, spawnSync } = require('child_process');
+const ui = require('./lib/ui');
+const { c, sym } = ui;
+
+const VERSION = require('../package.json').version;
+const PKG_ROOT = path.resolve(__dirname, '..');
+const isWindows = process.platform === 'win32';
+
+const VALID_RUNTIMES = ['claude', 'copilot', 'antigravity', 'opencode', 'all'];
+const VALID_SCOPES = ['user', 'project'];
+
+// =================================================================
+// Argument parsing — minimal, no deps
+// =================================================================
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  if (args.length === 0) return { cmd: 'help' };
+
+  const cmd = args[0];
+  const rest = args.slice(1);
+  const flags = {};
+  const positional = [];
+
+  for (let i = 0; i < rest.length; i++) {
+    const a = rest[i];
+    if (a === '--scope' || a === '-s') {
+      flags.scope = rest[++i];
+    } else if (a === '--verbose' || a === '-v') {
+      flags.verbose = true;
+    } else if (a === '--help' || a === '-h') {
+      flags.help = true;
+    } else if (a === '--version') {
+      flags.version = true;
+    } else if (a === '--no-color') {
+      flags.noColor = true;
+    } else if (a.startsWith('--')) {
+      const [k, v] = a.slice(2).split('=');
+      flags[k] = v === undefined ? true : v;
+    } else {
+      positional.push(a);
+    }
+  }
+
+  return { cmd, positional, flags };
+}
+
+// =================================================================
+// Spawn helpers — delegate to .sh / .ps1
+// =================================================================
+
+function getScriptPath(name) {
+  const ext = isWindows ? '.ps1' : '.sh';
+  return path.join(PKG_ROOT, 'bin', `${name}${ext}`);
+}
+
+function runShellScript(scriptName, scriptArgs = []) {
+  const scriptPath = getScriptPath(scriptName);
+
+  if (!fs.existsSync(scriptPath)) {
+    ui.fail(`Script nao encontrado: ${scriptPath}`);
+    return { code: 1 };
+  }
+
+  let cmd, args;
+  if (isWindows) {
+    cmd = 'powershell.exe';
+    args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, ...scriptArgs];
+  } else {
+    cmd = 'bash';
+    args = [scriptPath, ...scriptArgs];
+  }
+
+  const result = spawnSync(cmd, args, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+  });
+
+  return { code: result.status ?? 0 };
+}
+
+// =================================================================
+// Validation helpers
+// =================================================================
+
+function ensureRuntime(runtime) {
+  if (!runtime) {
+    ui.fail('Runtime obrigatorio.');
+    console.log('');
+    console.log(`  Uso: ${c.cyan}jdi install <runtime> [--scope user|project]${c.reset}`);
+    console.log(`  Runtimes: ${VALID_RUNTIMES.join(', ')}`);
+    console.log('');
+    process.exit(1);
+  }
+  if (!VALID_RUNTIMES.includes(runtime)) {
+    ui.fail(`Runtime invalido: ${runtime}`);
+    console.log(`  Validos: ${VALID_RUNTIMES.join(', ')}`);
+    process.exit(1);
+  }
+}
+
+function ensureScope(scope) {
+  if (scope && !VALID_SCOPES.includes(scope)) {
+    ui.fail(`Scope invalido: ${scope}`);
+    console.log(`  Validos: ${VALID_SCOPES.join(', ')}`);
+    process.exit(1);
+  }
+}
+
+// =================================================================
+// Commands
+// =================================================================
+
+function cmdInstall({ positional, flags }) {
+  const runtime = positional[0];
+  const scope = flags.scope || 'project';
+
+  ensureRuntime(runtime);
+  ensureScope(scope);
+
+  ui.banner();
+
+  ui.header(`Instalando JDI para ${c.bold}${runtime}${c.reset}`);
+  ui.info(`Diretorio: ${c.dim}${process.cwd()}${c.reset}`);
+  ui.info(`Scope: ${c.dim}${scope}${c.reset}`);
+  ui.info(`Plataforma: ${c.dim}${process.platform} (${isWindows ? 'PowerShell' : 'bash'})${c.reset}`);
+  console.log('');
+
+  const args = isWindows
+    ? ['-Runtime', runtime, '-Scope', scope]
+    : [runtime, '--scope', scope];
+
+  const sp = ui.spinner(`Instalando adapters em ${runtime}...`);
+  sp.stop();
+
+  const { code } = runShellScript('jdi-install', args);
+
+  if (code === 0) {
+    ui.successSummary('JDI instalado com sucesso', [
+      `${sym.success} Runtime: ${c.bold}${runtime}${c.reset}`,
+      `${sym.success} Scope: ${c.bold}${scope}${c.reset}`,
+      `${sym.success} Diretorio: ${c.dim}${process.cwd()}${c.reset}`,
+    ]);
+
+    const nextStepList = [
+      `Abre teu runtime (${runtime}) no diretorio do projeto`,
+      `Roda ${c.cyan}/jdi-new "<descricao do projeto>"${c.reset} pra inicializar`,
+      `Depois ${c.cyan}/jdi-bootstrap${c.reset} pra criar specialists per-project`,
+      `Comando ${c.cyan}npx jdi-cli doctor${c.reset} pra diagnostico`,
+    ];
+    ui.nextSteps(nextStepList);
+  } else {
+    ui.errorSummary('Instalacao falhou', [
+      `${sym.error} Exit code: ${code}`,
+      `${sym.info} Tente ${c.cyan}npx jdi-cli doctor${c.reset} pra diagnostico`,
+    ]);
+    process.exit(code);
+  }
+}
+
+function cmdBuild({ flags }) {
+  ui.banner();
+
+  ui.header('Building JDI runtimes');
+  ui.info(`Source: ${c.dim}${PKG_ROOT}/core/${c.reset}`);
+  ui.info(`Output: ${c.dim}${PKG_ROOT}/runtimes/${c.reset}`);
+  console.log('');
+
+  const { code } = runShellScript('jdi-build');
+
+  if (code === 0) {
+    ui.successSummary('Build completo', [
+      `${sym.success} 4 runtimes gerados (claude, copilot, antigravity, opencode)`,
+      `${sym.success} Adapters em ${c.dim}runtimes/${c.reset}`,
+    ]);
+    ui.nextSteps([
+      `Instala em projeto: ${c.cyan}npx jdi-cli install <runtime>${c.reset}`,
+      `Diagnostico: ${c.cyan}npx jdi-cli doctor${c.reset}`,
+    ]);
+  } else {
+    ui.errorSummary('Build falhou', [`${sym.error} Exit code: ${code}`]);
+    process.exit(code);
+  }
+}
+
+function cmdUpdate({ flags }) {
+  ui.banner();
+
+  ui.header('JDI Update');
+  ui.info(`Diretorio: ${c.dim}${process.cwd()}${c.reset}`);
+  console.log('');
+
+  const args = [];
+  if (isWindows) {
+    if (flags['force-specialists']) args.push('-ForceSpecialists');
+    if (flags['skip-specialists']) args.push('-SkipSpecialists');
+    if (flags['dry-run']) args.push('-DryRun');
+  } else {
+    if (flags['force-specialists']) args.push('--force-specialists');
+    if (flags['skip-specialists']) args.push('--skip-specialists');
+    if (flags['dry-run']) args.push('--dry-run');
+  }
+
+  const { code } = runShellScript('jdi-update', args);
+
+  if (code !== 0) {
+    process.exit(code);
+  }
+}
+
+function cmdUninstall({ positional, flags }) {
+  ui.banner();
+
+  ui.header('JDI Uninstall');
+  ui.info(`Diretorio: ${c.dim}${process.cwd()}${c.reset}`);
+  console.log('');
+
+  const runtime = positional[0] || 'all';
+  ensureRuntime(runtime);
+
+  const args = [];
+  if (isWindows) {
+    args.push('-Runtime', runtime);
+    if (flags.scope) args.push('-Scope', flags.scope);
+    if (flags.purge) args.push('-Purge');
+    if (flags.yes) args.push('-Yes');
+    if (flags['dry-run']) args.push('-DryRun');
+  } else {
+    args.push('--runtime', runtime);
+    if (flags.scope) args.push('--scope', flags.scope);
+    if (flags.purge) args.push('--purge');
+    if (flags.yes) args.push('--yes');
+    if (flags['dry-run']) args.push('--dry-run');
+  }
+
+  const { code } = runShellScript('jdi-uninstall', args);
+
+  if (code !== 0) {
+    process.exit(code);
+  }
+}
+
+function cmdInstallPlaywright({ flags }) {
+  ui.banner();
+
+  ui.header('JDI: Install Playwright + MCP');
+  ui.info(`Directory: ${c.dim}${process.cwd()}${c.reset}`);
+  console.log('');
+
+  const args = [];
+  if (isWindows) {
+    if (flags['skip-browser']) args.push('-SkipBrowser');
+    if (flags['skip-mcp'])     args.push('-SkipMcp');
+    if (flags.runtime)         args.push('-Runtime', flags.runtime);
+  } else {
+    if (flags['skip-browser']) args.push('--skip-browser');
+    if (flags['skip-mcp'])     args.push('--skip-mcp');
+    if (flags.runtime)         args.push('--runtime', flags.runtime);
+  }
+
+  const { code } = runShellScript('jdi-install-playwright', args);
+
+  if (code === 0) {
+    ui.successSummary('Playwright + MCP ready', [
+      `${sym.success} @playwright/test installed`,
+      `${sym.success} chromium browser ${flags['skip-browser'] ? 'skipped' : 'installed'}`,
+      `${sym.success} MCP config ${flags['skip-mcp'] ? 'skipped' : 'injected (where runtime present)'}`,
+    ]);
+    ui.nextSteps([
+      `Restart your runtime to pick up MCP changes`,
+      `Claude Code: ${c.cyan}/mcp${c.reset} to verify`,
+      `OpenCode: ${c.cyan}opencode reload${c.reset}`,
+    ]);
+  } else {
+    ui.errorSummary('Playwright install failed', [`${sym.error} Exit code: ${code}`]);
+    process.exit(code);
+  }
+}
+
+function cmdInstallCaveman({ flags }) {
+  ui.banner();
+
+  ui.header('JDI: Install Caveman plugin');
+  ui.info(`Directory: ${c.dim}${process.cwd()}${c.reset}`);
+  console.log('');
+
+  const args = [];
+  if (isWindows) {
+    if (flags.repo)  args.push('-Repo', flags.repo);
+    if (flags.scope) args.push('-Scope', flags.scope);
+    if (flags.force) args.push('-Force');
+  } else {
+    if (flags.repo)  args.push('--repo', flags.repo);
+    if (flags.scope) args.push('--scope', flags.scope);
+    if (flags.force) args.push('--force');
+  }
+
+  const { code } = runShellScript('jdi-install-caveman', args);
+
+  if (code === 0) {
+    ui.successSummary('Caveman ready', [
+      `${sym.success} Plugin cloned`,
+      `${sym.info} Restart Claude Code to load`,
+    ]);
+    ui.nextSteps([
+      `Verify: ${c.cyan}/caveman-help${c.reset}`,
+      `Toggle mode: ${c.cyan}/caveman lite|full|ultra${c.reset}`,
+    ]);
+  } else {
+    ui.errorSummary('Caveman install failed', [`${sym.error} Exit code: ${code}`]);
+    process.exit(code);
+  }
+}
+
+function cmdDoctor({ flags }) {
+  ui.banner();
+
+  ui.header('JDI Doctor');
+  ui.info(`Diretorio atual: ${c.dim}${process.cwd()}${c.reset}`);
+  console.log('');
+
+  const args = flags.verbose ? (isWindows ? ['-Verbose'] : ['--verbose']) : [];
+  const { code } = runShellScript('jdi-doctor', args);
+
+  if (code !== 0) {
+    process.exit(code);
+  }
+}
+
+function cmdHelp() {
+  ui.banner();
+
+  console.log(`${c.bold}Uso:${c.reset}`);
+  console.log(`  ${c.cyan}npx jdi-cli <comando> [opcoes]${c.reset}`);
+  console.log('');
+
+  console.log(`${c.bold}Comandos:${c.reset}`);
+  console.log(`  ${c.cyan}install${c.reset} ${c.gray}<runtime>${c.reset}      Instala JDI no projeto atual`);
+  console.log(`  ${c.cyan}update${c.reset}                 Atualiza JDI ja instalado (preserva state)`);
+  console.log(`  ${c.cyan}uninstall${c.reset} ${c.gray}[runtime]${c.reset}    Remove JDI do projeto (preserva .jdi/ por default)`);
+  console.log(`  ${c.cyan}build${c.reset}                  Re-builda runtimes/ a partir de core/`);
+  console.log(`  ${c.cyan}doctor${c.reset}                 Diagnostico do projeto + JDI`);
+  console.log(`  ${c.cyan}install-playwright${c.reset}     Instala @playwright/test + chromium + MCP config`);
+  console.log(`  ${c.cyan}install-caveman${c.reset}        Instala plugin caveman (modo ultra-compresso)`);
+  console.log(`  ${c.cyan}help${c.reset}                   Mostra esta ajuda`);
+  console.log(`  ${c.cyan}--version${c.reset}              Mostra versao`);
+  console.log('');
+
+  console.log(`${c.bold}Runtimes (install):${c.reset}`);
+  console.log(`  ${c.cyan}claude${c.reset}                 Claude Code`);
+  console.log(`  ${c.cyan}copilot${c.reset}                GitHub Copilot`);
+  console.log(`  ${c.cyan}antigravity${c.reset}            Google Antigravity`);
+  console.log(`  ${c.cyan}opencode${c.reset}               OpenCode`);
+  console.log(`  ${c.cyan}all${c.reset}                    Todos os 4`);
+  console.log('');
+
+  console.log(`${c.bold}Opcoes:${c.reset}`);
+  console.log(`  ${c.cyan}--scope${c.reset} ${c.gray}<user|project|both>${c.reset}  Escopo (default install: project; default uninstall: both)`);
+  console.log(`  ${c.cyan}--verbose${c.reset}              Output detalhado (so doctor)`);
+  console.log(`  ${c.cyan}--dry-run${c.reset}              Mostra o que faria sem aplicar (update, uninstall)`);
+  console.log(`  ${c.cyan}--purge${c.reset}                Uninstall: remove tambem .jdi/ (DESTRUTIVO)`);
+  console.log(`  ${c.cyan}--yes${c.reset}                  Uninstall: pula confirmacoes interativas`);
+  console.log(`  ${c.cyan}--force-specialists${c.reset}    Update: regenera specialists sem perguntar`);
+  console.log(`  ${c.cyan}--skip-specialists${c.reset}     Update: nao mexe em specialists`);
+  console.log(`  ${c.cyan}--no-color${c.reset}             Desabilita cores ANSI`);
+  console.log(`  ${c.cyan}-h, --help${c.reset}             Esta ajuda`);
+  console.log('');
+
+  console.log(`${c.bold}Exemplos:${c.reset}`);
+  console.log(`  ${c.dim}# Instalacao no projeto atual${c.reset}`);
+  console.log(`  ${c.cyan}npx jdi-cli@latest install opencode${c.reset}`);
+  console.log('');
+  console.log(`  ${c.dim}# Atualizar projeto ja instalado pra versao mais recente${c.reset}`);
+  console.log(`  ${c.cyan}npx jdi-cli@latest update${c.reset}`);
+  console.log('');
+  console.log(`  ${c.dim}# Preview do que update faria${c.reset}`);
+  console.log(`  ${c.cyan}npx jdi-cli@latest update --dry-run${c.reset}`);
+  console.log('');
+  console.log(`  ${c.dim}# Desinstalar (preserva .jdi/ state)${c.reset}`);
+  console.log(`  ${c.cyan}npx jdi-cli@latest uninstall${c.reset}`);
+  console.log('');
+  console.log(`  ${c.dim}# Desinstalar tudo, incluindo state files${c.reset}`);
+  console.log(`  ${c.cyan}npx jdi-cli@latest uninstall --purge --yes${c.reset}`);
+  console.log('');
+  console.log(`  ${c.dim}# Diagnostico${c.reset}`);
+  console.log(`  ${c.cyan}npx jdi-cli@latest doctor${c.reset}`);
+  console.log('');
+
+  console.log(`${c.bold}Saiba mais:${c.reset} ${c.cyan}https://github.com/<owner>/jdi${c.reset}`);
+  console.log('');
+}
+
+function cmdVersion() {
+  console.log(`jdi-cli ${c.bold}v${VERSION}${c.reset}`);
+}
+
+// =================================================================
+// Main dispatcher
+// =================================================================
+
+function main() {
+  const parsed = parseArgs(process.argv);
+
+  if (parsed.flags && parsed.flags.noColor) {
+    process.env.NO_COLOR = '1';
+  }
+
+  if (parsed.flags && parsed.flags.version) {
+    cmdVersion();
+    return;
+  }
+
+  switch (parsed.cmd) {
+    case 'install':
+      cmdInstall(parsed);
+      break;
+    case 'update':
+    case 'upgrade':
+      cmdUpdate(parsed);
+      break;
+    case 'uninstall':
+    case 'remove':
+      cmdUninstall(parsed);
+      break;
+    case 'build':
+      cmdBuild(parsed);
+      break;
+    case 'install-playwright':
+    case 'playwright':
+      cmdInstallPlaywright(parsed);
+      break;
+    case 'install-caveman':
+    case 'caveman':
+      cmdInstallCaveman(parsed);
+      break;
+    case 'doctor':
+      cmdDoctor(parsed);
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      cmdHelp();
+      break;
+    case '--version':
+    case '-V':
+      cmdVersion();
+      break;
+    default:
+      ui.fail(`Comando desconhecido: ${parsed.cmd}`);
+      console.log(`  Use ${c.cyan}npx jdi-cli help${c.reset} pra ver comandos disponiveis.`);
+      process.exit(1);
+  }
+}
+
+main();

package/bin/lib/jdi-monitor.ps1

@@ -0,0 +1,66 @@
+# jdi-monitor.ps1 — context budget monitor (heuristica)
+#
+# Uso:
+#   pwsh -File jdi-monitor.ps1 -Paths @("a.md","b.md")
+#
+# Estima tokens consumidos por leitura inline dos paths informados
+# (heuristica chars/4 = tokens). Le .jdi/config.json pra resolver
+# context_window + thresholds. Imprime status pra stderr e sai 0.
+#
+# Status:
+#   PEAK     0-30%   ok, full operations
+#   GOOD     30-60%  ok, prefere frontmatter
+#   WARN     60-70%  context aquecendo, considere checkpoint
+#   CRITICAL 70%+    fracture zone — sugere /jdi-thread
+
+param(
+  [string[]]$Paths = @()
+)
+
+$ErrorActionPreference = "Stop"
+
+# Defaults
+$ContextWindow = 200000
+$WarnPct = 60
+$CriticalPct = 70
+
+if (Test-Path -LiteralPath ".jdi/config.json") {
+  try {
+    $cfg = Get-Content -LiteralPath ".jdi/config.json" -Raw -Encoding UTF8 | ConvertFrom-Json
+    if ($cfg.context_window) { $ContextWindow = [int]$cfg.context_window }
+    if ($cfg.thresholds) {
+      if ($cfg.thresholds.warn_pct) { $WarnPct = [int]$cfg.thresholds.warn_pct }
+      if ($cfg.thresholds.critical_pct) { $CriticalPct = [int]$cfg.thresholds.critical_pct }
+    }
+  } catch {
+    # config invalido — usa defaults
+  }
+}
+
+$totalChars = 0
+foreach ($p in $Paths) {
+  if (Test-Path -LiteralPath $p -PathType Leaf) {
+    $totalChars += (Get-Item -LiteralPath $p).Length
+  }
+}
+
+$tokens = [int]([math]::Floor($totalChars / 4))
+$pct = if ($ContextWindow -gt 0) { [int]([math]::Floor($tokens * 100 / $ContextWindow)) } else { 0 }
+
+$state = "PEAK"
+$hint = ""
+if ($pct -ge $CriticalPct) {
+  $state = "CRITICAL"
+  $hint = "fracture zone — considere /jdi-thread (proxima phase em sessao nova)"
+} elseif ($pct -ge $WarnPct) {
+  $state = "WARN"
+  $hint = "context aquecendo — checkpoint recomendado"
+} elseif ($pct -ge 30) {
+  $state = "GOOD"
+}
+
+$msg = "[jdi-monitor] $state ${pct}% (~${tokens} tokens / ${ContextWindow})"
+if ($hint) { $msg = "$msg. $hint" }
+
+[Console]::Error.WriteLine($msg)
+exit 0

package/bin/lib/jdi-monitor.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+# jdi-monitor.sh — context budget monitor (heuristica)
+#
+# Uso:
+#   jdi-monitor.sh [path1 path2 ...]
+#
+# Estima tokens consumidos por leitura inline dos paths informados
+# (heuristica chars/4 = tokens). Le .jdi/config.json pra resolver
+# context_window + thresholds. Imprime status pra stderr e sai 0.
+#
+# Status:
+#   PEAK     0-30%   ok, full operations
+#   GOOD     30-60%  ok, prefere frontmatter
+#   WARN     60-70%  context aquecendo, considere checkpoint
+#   CRITICAL 70%+    fracture zone — sugere /jdi-thread
+#
+# Sai 0 sempre (nao bloqueia). Saida via stderr nao polui pipe.
+
+set -euo pipefail
+
+CONFIG=".jdi/config.json"
+
+# Defaults se config ausente
+CONTEXT_WINDOW=200000
+WARN_PCT=60
+CRITICAL_PCT=70
+
+if [ -f "$CONFIG" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    CONTEXT_WINDOW=$(jq -r '.context_window // 200000' "$CONFIG")
+    WARN_PCT=$(jq -r '.thresholds.warn_pct // 60' "$CONFIG")
+    CRITICAL_PCT=$(jq -r '.thresholds.critical_pct // 70' "$CONFIG")
+  else
+    # Fallback grep — funciona pro JSON simples do JDI
+    CONTEXT_WINDOW=$(grep -oE '"context_window":[[:space:]]*[0-9]+' "$CONFIG" | head -1 | grep -oE '[0-9]+' || echo 200000)
+    WARN_PCT=$(grep -oE '"warn_pct":[[:space:]]*[0-9]+' "$CONFIG" | head -1 | grep -oE '[0-9]+' || echo 60)
+    CRITICAL_PCT=$(grep -oE '"critical_pct":[[:space:]]*[0-9]+' "$CONFIG" | head -1 | grep -oE '[0-9]+' || echo 70)
+  fi
+fi
+
+# Soma chars dos paths informados
+TOTAL_CHARS=0
+for p in "$@"; do
+  if [ -f "$p" ]; then
+    SZ=$(wc -c < "$p" | tr -d ' ')
+    TOTAL_CHARS=$((TOTAL_CHARS + SZ))
+  fi
+done
+
+# Heuristica: 4 chars ~ 1 token
+TOKENS=$((TOTAL_CHARS / 4))
+PCT=$((TOKENS * 100 / CONTEXT_WINDOW))
+
+if [ "$PCT" -ge "$CRITICAL_PCT" ]; then
+  STATE="CRITICAL"
+  HINT="fracture zone — considere /jdi-thread (proxima phase em sessao nova)"
+elif [ "$PCT" -ge "$WARN_PCT" ]; then
+  STATE="WARN"
+  HINT="context aquecendo — checkpoint recomendado"
+elif [ "$PCT" -ge 30 ]; then
+  STATE="GOOD"
+  HINT=""
+else
+  STATE="PEAK"
+  HINT=""
+fi
+
+if [ -n "$HINT" ]; then
+  echo "[jdi-monitor] $STATE ${PCT}% (~${TOKENS} tokens / ${CONTEXT_WINDOW}). $HINT" >&2
+else
+  echo "[jdi-monitor] $STATE ${PCT}% (~${TOKENS} tokens / ${CONTEXT_WINDOW})" >&2
+fi
+
+exit 0

package/bin/lib/jdi-truncate.ps1

@@ -0,0 +1,96 @@
+# jdi-truncate.ps1 — markdown-aware truncation pra context budget
+#
+# Uso:
+#   pwsh -File jdi-truncate.ps1 -Path <path> [-Budget 8192]
+#
+# Estrategia:
+#   - Preserva YAML frontmatter inteiro
+#   - Preserva TODAS as linhas de heading (#, ##, ...)
+#   - Preserva 1a linha nao-vazia de cada secao
+#   - Resto vira "[... N lines omitted]"
+#   - Footer aponta pro arquivo original
+#
+# Se file <= budget, ecoa inteiro. Output sempre pra stdout.
+
+param(
+  [Parameter(Mandatory = $true)]
+  [string]$Path,
+
+  [int]$Budget = 8192
+)
+
+$ErrorActionPreference = "Stop"
+
+if (-not (Test-Path -LiteralPath $Path -PathType Leaf)) {
+  Write-Error "arquivo nao encontrado: $Path"
+  exit 1
+}
+
+$content = Get-Content -LiteralPath $Path -Raw -Encoding UTF8
+if ($null -eq $content) { $content = "" }
+
+if ($content.Length -le $Budget) {
+  Write-Output $content
+  exit 0
+}
+
+$lines = $content -split "`r?`n"
+$inFrontmatter = $false
+$paragraphKept = $false
+$omitted = 0
+$out = New-Object System.Collections.Generic.List[string]
+
+for ($i = 0; $i -lt $lines.Length; $i++) {
+  $line = $lines[$i]
+
+  # Frontmatter (so se comecar na linha 1 = index 0)
+  if ($i -eq 0 -and $line -eq "---") {
+    $inFrontmatter = $true
+    $out.Add($line)
+    continue
+  }
+  if ($inFrontmatter) {
+    $out.Add($line)
+    if ($line -eq "---") {
+      $inFrontmatter = $false
+    }
+    continue
+  }
+
+  # Heading — sempre preserva
+  if ($line -match '^#{1,6}\s') {
+    if ($omitted -gt 0) {
+      $out.Add("[... $omitted lines omitted]")
+      $omitted = 0
+    }
+    $out.Add($line)
+    $paragraphKept = $false
+    continue
+  }
+
+  # Linha vazia
+  if ($line -match '^\s*$') {
+    if (-not $paragraphKept) {
+      $out.Add($line)
+    } else {
+      $omitted++
+    }
+    continue
+  }
+
+  # Conteudo
+  if (-not $paragraphKept) {
+    $out.Add($line)
+    $paragraphKept = $true
+  } else {
+    $omitted++
+  }
+}
+
+if ($omitted -gt 0) {
+  $out.Add("[... $omitted lines omitted]")
+}
+$out.Add("")
+$out.Add("[Truncated by jdi-truncate. Read $Path for full content]")
+
+Write-Output ($out -join "`n")