@plures/pluresdb 1.5.3 → 2.9.6

package/scripts/setup-libclang.ps1

@@ -1,209 +0,0 @@
-<#
-.SYNOPSIS
-    Ensures libclang (LLVM) is installed and configures the LIBCLANG_PATH required by bindgen-based crates.
-
-.DESCRIPTION
-    This script automates the detection or installation of libclang on Windows machines.
-    It will:
-      1. Check existing environment variables and well-known locations for libclang.dll
-      2. Optionally install LLVM via winget or Chocolatey if libclang is missing
-      3. Configure the LIBCLANG_PATH environment variable (user scope) once libclang is found
-      4. Optionally append the path to the current session PATH so cargo build/test immediately picks it up
-
-    Run it from the repository root before building Rust components that depend on bindgen (e.g., zstd-sys).
-
-.PARAMETER ForceInstall
-    Always attempt to (re)install LLVM even if libclang is already detected.
-
-.PARAMETER ConfigureCurrentProcess
-    Also updates $env:LIBCLANG_PATH and $env:PATH for the current PowerShell session
-    in addition to setting the persisted user-level environment variable.
-
-.PARAMETER SkipInstall
-    Do not attempt to install LLVM automatically. The script will fail if libclang is not found.
-
-.EXAMPLE
-    pwsh ./scripts/setup-libclang.ps1
-
-.EXAMPLE
-    pwsh ./scripts/setup-libclang.ps1 -ConfigureCurrentProcess
-
-.NOTES
-    - Requires either winget or Chocolatey for automated installation.
-    - When installing via winget, administrative consent may be required for the first run.
-    - After the user-level environment variable is written you should restart your shell (unless ConfigureCurrentProcess was supplied).
-#>
-[CmdletBinding()]
-param(
-    [switch]$ForceInstall,
-    [switch]$ConfigureCurrentProcess,
-    [switch]$SkipInstall
-)
-
-function Write-Info {
-    param([string]$Message)
-    Write-Host "[INFO]  $Message" -ForegroundColor Cyan
-}
-
-function Write-Success {
-    param([string]$Message)
-    Write-Host "[ OK ]  $Message" -ForegroundColor Green
-}
-
-function Write-WarningMessage {
-    param([string]$Message)
-    Write-Host "[WARN]  $Message" -ForegroundColor Yellow
-}
-
-function Write-ErrorMessage {
-    param([string]$Message)
-    Write-Host "[FAIL]  $Message" -ForegroundColor Red
-}
-
-function Test-CommandExists {
-    param([string]$Name)
-    return [bool](Get-Command $Name -ErrorAction SilentlyContinue)
-}
-
-function Get-EnvLibClangPath {
-    $env:LIBCLANG_PATH
-}
-
-function Test-LibClangInPath {
-    param([string]$Directory)
-    if ([string]::IsNullOrWhiteSpace($Directory)) {
-        return $null
-    }
-    $candidate = Join-Path -Path $Directory -ChildPath "libclang.dll"
-    if (Test-Path $candidate) {
-        return (Get-Item $candidate).Directory.FullName
-    }
-    return $null
-}
-
-function Get-KnownLibClangLocations {
-    $paths = @()
-
-    # Explicit environment variable first
-    $envPath = Get-EnvLibClangPath
-    if (-not [string]::IsNullOrWhiteSpace($envPath)) {
-        $paths += $envPath
-    }
-
-    # LLVM default installation
-    $paths += @(
-        "$env:ProgramFiles\LLVM\bin",
-        "$env:ProgramFiles\LLVM\lib",
-        "$env:ProgramFiles\LLVM\lib64",
-        "$env:ProgramFiles(x86)\LLVM\bin",
-        "$env:ProgramFiles(x86)\LLVM\lib"
-    )
-
-    # Visual Studio (MSVC) bundled LLVM/Clang
-    $vsRoot = Join-Path $env:ProgramFiles "Microsoft Visual Studio"
-    if (Test-Path $vsRoot) {
-        $paths += Get-ChildItem -Path $vsRoot -Directory -Recurse -Filter "libclang.dll" -ErrorAction SilentlyContinue |
-            ForEach-Object { $_.Directory.FullName } |
-            Select-Object -Unique
-    }
-
-    # Generic entries that appear in PATH (e.g., if user installed LLVM elsewhere)
-    $paths += [Environment]::GetEnvironmentVariable("PATH", "Machine").Split(';')
-    $paths += [Environment]::GetEnvironmentVariable("PATH", "User").Split(';')
-
-    # Remove duplicates/empty
-    return $paths | Where-Object { -not [string]::IsNullOrWhiteSpace($_) } | Select-Object -Unique
-}
-
-function Find-LibClang {
-    $locations = Get-KnownLibClangLocations
-    foreach ($location in $locations) {
-        $resolved = Test-LibClangInPath -Directory $location
-        if ($resolved) {
-            return $resolved
-        }
-    }
-    return $null
-}
-
-function Install-LLVM {
-    Write-Info "Attempting to install LLVM (includes libclang)..."
-
-    if (Test-CommandExists -Name "winget") {
-        try {
-            winget install LLVM.LLVM --silent --accept-package-agreements --accept-source-agreements | Out-Null
-            Write-Success "LLVM installed via winget"
-            return $true
-        }
-        catch {
-            Write-WarningMessage "winget install failed: $($_.Exception.Message)"
-        }
-    }
-    elseif (Test-CommandExists -Name "choco") {
-        try {
-            choco install llvm -y --no-progress | Out-Null
-            Write-Success "LLVM installed via Chocolatey"
-            return $true
-        }
-        catch {
-            Write-WarningMessage "Chocolatey install failed: $($_.Exception.Message)"
-        }
-    }
-    else {
-        Write-WarningMessage "Neither winget nor Chocolatey is available for automated installation."
-    }
-
-    return $false
-}
-
-function Set-LibClangEnvironment {
-    param(
-        [Parameter(Mandatory = $true)][string]$Directory,
-        [switch]$ConfigureProcess
-    )
-
-    Write-Info "Setting LIBCLANG_PATH user environment variable to '$Directory'"
-    [Environment]::SetEnvironmentVariable("LIBCLANG_PATH", $Directory, "User")
-
-    if ($ConfigureProcess) {
-        $env:LIBCLANG_PATH = $Directory
-        if ($env:PATH -notlike "*$Directory*") {
-            $env:PATH = "$Directory;$env:PATH"
-        }
-        Write-Info "Updated current session PATH for immediate use"
-    }
-
-    Write-Success "LIBCLANG_PATH configured. Restart PowerShell or open a new terminal to pick up user-level changes."
-}
-
-try {
-    if ($ForceInstall -and $SkipInstall) {
-        throw "Cannot use -ForceInstall together with -SkipInstall."
-    }
-
-    $libclangDir = Find-LibClang
-
-    if ($ForceInstall -or (-not $libclangDir)) {
-        if ($SkipInstall) {
-            throw "libclang was not found and installation is disabled (SkipInstall)."
-        }
-        $installed = Install-LLVM
-        if (-not $installed) {
-            throw "Automatic LLVM installation failed. Please install LLVM manually and rerun this script."
-        }
-        $libclangDir = Find-LibClang
-    }
-
-    if (-not $libclangDir) {
-        throw "libclang.dll could not be located even after installation. Please install LLVM manually and rerun."
-    }
-
-    Write-Success "Found libclang at '$libclangDir'"
-    Set-LibClangEnvironment -Directory $libclangDir -ConfigureProcess:$ConfigureCurrentProcess
-
-    Write-Info "You can now run 'cargo build' / 'cargo test' successfully."
-}
-catch {
-    Write-ErrorMessage $_
-    exit 1
-}

package/scripts/update-changelog.js

@@ -1,214 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Updates CHANGELOG.md with commits since the last tag
- * This script is meant to be run during CI before version bumping
- * 
- * Usage: node scripts/update-changelog.js <version>
- */
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-function run(cmd) {
-  try {
-    return execSync(cmd, { encoding: 'utf8', stdio: 'pipe' }).trim();
-  } catch (e) {
-    return null;
-  }
-}
-
-function getCommitsSinceLastTag() {
-  const lastTag = run('git describe --tags --abbrev=0 2>/dev/null');
-  if (!lastTag) {
-    console.log('No previous tags found, analyzing all commits');
-    const commits = run('git log --format="%s"');
-    return commits ? commits.split('\n').filter(Boolean) : [];
-  }
-
-  const range = `${lastTag}..HEAD`;
-  const commits = run(`git log --format="%s" ${range}`);
-  if (!commits) {
-    console.log('No commits since last tag');
-    return [];
-  }
-
-  return commits.split('\n').filter(Boolean);
-}
-
-function categorizeCommits(commits) {
-  const categories = {
-    feat: [],
-    fix: [],
-    docs: [],
-    style: [],
-    refactor: [],
-    test: [],
-    chore: [],
-    perf: [],
-    ci: [],
-    build: [],
-    other: [],
-  };
-
-  commits.forEach((commit) => {
-    // Skip release commits
-    if (commit.match(/^chore\(release\):/)) {
-      return;
-    }
-
-    const match = commit.match(/^(\w+)(\(.+\))?: (.+)/);
-    if (match) {
-      const [, type, , description] = match;
-      if (categories[type]) {
-        categories[type].push(description);
-      } else {
-        categories.other.push(commit);
-      }
-    } else {
-      categories.other.push(commit);
-    }
-  });
-
-  return categories;
-}
-
-function generateChangelogEntry(version, categories) {
-  const today = new Date().toISOString().split('T')[0];
-  let entry = `## [${version}] - ${today}\n\n`;
-  let hasContent = false;
-
-  if (categories.feat.length > 0) {
-    entry += '### Added\n\n';
-    categories.feat.forEach((item) => {
-      entry += `- ${item}\n`;
-    });
-    entry += '\n';
-    hasContent = true;
-  }
-
-  if (categories.fix.length > 0) {
-    entry += '### Fixed\n\n';
-    categories.fix.forEach((item) => {
-      entry += `- ${item}\n`;
-    });
-    entry += '\n';
-    hasContent = true;
-  }
-
-  if (categories.refactor.length > 0 || categories.style.length > 0 || categories.perf.length > 0) {
-    entry += '### Changed\n\n';
-    [...categories.refactor, ...categories.style, ...categories.perf].forEach((item) => {
-      entry += `- ${item}\n`;
-    });
-    entry += '\n';
-    hasContent = true;
-  }
-
-  if (categories.docs.length > 0) {
-    entry += '### Documentation\n\n';
-    categories.docs.forEach((item) => {
-      entry += `- ${item}\n`;
-    });
-    entry += '\n';
-    hasContent = true;
-  }
-
-  if (categories.test.length > 0 || categories.chore.length > 0 || categories.ci.length > 0 || categories.build.length > 0) {
-    entry += '### Developer Experience\n\n';
-    [...categories.test, ...categories.chore, ...categories.ci, ...categories.build].forEach((item) => {
-      entry += `- ${item}\n`;
-    });
-    entry += '\n';
-    hasContent = true;
-  }
-
-  if (categories.other.length > 0) {
-    entry += '### Other\n\n';
-    categories.other.forEach((item) => {
-      entry += `- ${item}\n`;
-    });
-    entry += '\n';
-    hasContent = true;
-  }
-
-  if (!hasContent) {
-    entry += '- Maintenance and improvements\n\n';
-  }
-
-  return entry;
-}
-
-function updateChangelog(newEntry) {
-  const changelogPath = path.join(process.cwd(), 'CHANGELOG.md');
-  
-  if (!fs.existsSync(changelogPath)) {
-    console.log('CHANGELOG.md not found, creating new one');
-    const content = `# Changelog\n\nAll notable changes to this project will be documented in this file.\n\n${newEntry}`;
-    fs.writeFileSync(changelogPath, content);
-    console.log('Created CHANGELOG.md');
-    return;
-  }
-
-  const content = fs.readFileSync(changelogPath, 'utf8');
-  const lines = content.split('\n');
-  let insertIndex = -1;
-
-  // Find the position after the header and before the first version entry
-  for (let i = 0; i < lines.length; i++) {
-    if (lines[i].startsWith('## [') && !lines[i].includes('[Unreleased]')) {
-      insertIndex = i;
-      break;
-    }
-  }
-
-  if (insertIndex === -1) {
-    // No previous releases found, insert after any "Unreleased" section
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].startsWith('## [Unreleased]')) {
-        // Skip the unreleased section
-        let j = i + 1;
-        while (j < lines.length && !lines[j].startsWith('##')) {
-          j++;
-        }
-        insertIndex = j;
-        break;
-      } else if (lines[i].startsWith('# ')) {
-        // Found the main header, insert after it
-        insertIndex = i + 2;
-        break;
-      }
-    }
-  }
-
-  if (insertIndex === -1) {
-    // Last resort: append at the end
-    lines.push('', newEntry);
-  } else {
-    // Insert the new entry
-    lines.splice(insertIndex, 0, newEntry);
-  }
-
-  fs.writeFileSync(changelogPath, lines.join('\n'));
-  console.log('✅ Updated CHANGELOG.md');
-}
-
-function main() {
-  const version = process.argv[2];
-  if (!version) {
-    console.error('Usage: node scripts/update-changelog.js <version>');
-    process.exit(1);
-  }
-
-  const commits = getCommitsSinceLastTag();
-  if (commits.length === 0) {
-    console.log('No commits to add to changelog, creating minimal entry');
-  }
-
-  const categories = categorizeCommits(commits);
-  const entry = generateChangelogEntry(version, categories);
-  updateChangelog(entry);
-}
-
-main();

package/web/README.md

@@ -1,27 +0,0 @@
-# Web UI (Svelte)
-
-This folder contains a Svelte-based reactive UI for PluresDB.
-
-- svelte/ source using Vite
-- Built assets go to web/dist/ and are served by the PluresDB HTTP server
-
-## Dev
-
-Use Node 18+.
-
-```
-cd web/svelte
-npm i
-npm run dev
-```
-
-Configure the API base URL if needed (defaults to same origin).
-
-## Build
-
-```
-cd web/svelte
-npm run build
-```
-
-This outputs to ../dist/. Start PluresDB serve and open the port+1 URL printed in the console.

package/web/svelte/package.json

@@ -1,31 +0,0 @@
-{
-  "name": "pluresdb-ui",
-  "private": true,
-  "version": "0.0.1",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "preview": "vite preview"
-  },
-  "devDependencies": {
-    "@codemirror/commands": "^6.6.0",
-    "@codemirror/lang-json": "^6.0.1",
-    "@codemirror/lint": "^6.8.0",
-    "@codemirror/state": "^6.4.0",
-    "@codemirror/theme-one-dark": "^6.1.2",
-    "@codemirror/view": "^6.28.1",
-    "@sveltejs/vite-plugin-svelte": "^6.2.1",
-    "ajv": "^8.12.0",
-    "svelte": "^5.17.3",
-    "vite": "^7.2.2"
-  },
-  "dependencies": {
-    "@monaco-editor/loader": "^1.5.0",
-    "cytoscape": "^3.29.3",
-    "cytoscape-cola": "^2.5.1",
-    "cytoscape-cose-bilkent": "^4.1.0",
-    "cytoscape-dagre": "^2.5.0",
-    "monaco-editor": "^0.49.0"
-  }
-}