Skip to content

Releases

UNFUCK v0.2.1 — Deep Docker Compose Modeling & Causal Environment Resolution

Choose a tag to compare

@roonakyadav roonakyadav released this 21 Sep 18:12

What's New in v0.2.1

  • Docker Compose Service Modeling: Full lifecycle and state analysis of services declared in docker-compose.yml, compose.yaml, and variants.
  • Compose Blockers & Causal Tracing: Detects uninstantiable Compose stacks due to missing .env files or unresolved environment variables (${VAR}), with end-to-end causal chain explanation.
  • Container Observation & Health Tracking: Live discovery of containers (docker ps -a) tracking ports, labels, exit codes, and health statuses (Uncreated, Stopped, Unhealthy, Running).
  • Strict Container-to-Service Isolation: Compose project and service label matching (com.docker.compose.project, com.docker.compose.service) ensuring foreign host containers never satisfy project database requirements.
  • Multi-Component Architecture & Provenance Attribution: Discovers monorepo subcomponents (web/, mobile/, crates/*, packages/*). Scored attribution strictly links runtime and tool requirements to their declaring components (e.g. Java pin strictly to mobile).
  • Typed Tool Taxonomy & Operational Scopes: Distinguishes Runtimes, Package Managers, Developer Tools, Build Tools, and Code Generators across operational scopes (RequiredForProject, RequiredForBuild, RequiredForTask, Optional).
  • Set-Theoretic Multi-Source Constraint Consolidation: Merges configuration signals (mise.toml, package.json, .nvmrc) via constraint intersection while preserving exact version pins (==).

Quick Install (Linux x86_64)

curl -fsSL https://raw.githubusercontent.com/axonel/unfuck/main/install.sh | sh

SHA256 Checksum:

d394a3612d9b888cda0d0dce55bc5b5b664f445df7d49a892fae7508e6e54d1b  unfuck-v0.2.1-linux-x86_64.tar.gz

Full Changelog: v0.1.1...v0.2.1

UNFUCK v0.1.1 — Hardened Release & Installation Experience

Choose a tag to compare

@roonakyadav roonakyadav released this 21 Sep 16:34

UNFUCK v0.1.1: Release Hardening & Clean-Room Verification

This release hardens the public distribution, installation, and error-handling pipeline of UNFUCK.

Key Improvements & Fixes

  • Hardened One-Line Installer (install.sh):
    • Atomic installation using temporary swap files (.unfuck.tmp.27757) to eliminate ETXTBSY (text file busy) on Linux.
    • Automatic prerequisite validation for tar, gzip, curl/wget, and SHA256 checksum utilities.
    • Dynamic latest release lookup with resilient pinned fallback.
    • Write permission checks on target directory ($HOME/.local/bin or custom override).
  • Standardized CLI Exit Codes:
    • 0: Environment compatible / all invariants hold / clean run.
    • 1: Predicted failures or environment constraint violations detected.
    • 2: Invalid invocation, nonexistent target path, or runtime error.
  • Robust Path & Syntax Validation:
    • Validates repository path existence and directory type, returning clear diagnostics instead of silent fallbacks.
    • Detects syntax errors in package.json and pyproject.toml with line-number evidence rather than ignoring malformed files.
  • Pure JSON Contract:
    • Guaranteed valid JSON on stdout for unfuck [PATH] --json on both successful runs and failure/error conditions.
    • Zero terminal formatting or ANSI codes mixed into JSON output.
  • Automated Clean-Room Smoke Test:
    • Added scripts/test-install.sh for verifying installation across isolated sandboxes.

Installation

curl -fsSL https://raw.githubusercontent.com/axonel/unfuck/main/install.sh | sh

Full Changelog: v0.1.0...v0.1.1

UNFUCK v0.1.0

Choose a tag to compare

@roonakyadav roonakyadav released this 21 Sep 16:25

First public installable release of UNFUCK — Development Environment Resolution Engine.

Highlights

  • Deterministic Machine Scanner: Real Linux procfs & network inspection without blind shell commands.
  • Repository Signal Discovery: Deep manifest analysis for Node/Bun, Python, Docker, PostgreSQL.
  • Data-Driven Constraint Engine: Semantic versioning and port/service constraint evaluation.
  • Environment Graph: Dependency modeling with causal tracing back to earliest violated invariants.
  • Deterministic Failure Prediction: Catches runtime mismatches and port collisions before execution.
  • Read-Only Verification: Non-destructive environment validation.
  • First-Class JSON API: Full machine-readable outputs for automation.
  • Zero AI Required: 100% deterministic systems software.

Quick Install (Linux x86_64)

curl -fsSL https://raw.githubusercontent.com/axonel/unfuck/main/install.sh | sh

Verification Checksum (SHA256)

fa71a4bbf018bc9a43bf9a523fdd2cb998edff2a593d051cb094b2fdb1542e77  unfuck-v0.1.0-linux-x86_64.tar.gz

Full Changelog: https://github.com/axonel/unfuck/commits/v0.1.0