refactor(updater): migrate from reqwest to ureq for lightweight builds

v0.7.2

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: 'https://dalink.to/dexoron'

.github/workflows/release.yml

@@ -21,6 +21,10 @@ on:
         description: "Update AUR packages (dcr & dcr-bin)"
         type: boolean
         default: false 
+      run_aur_dev:
+        description: "Update Dev AUR packages (dcr-dev, dcr-dev-bin)"
+        type: boolean
+        default: false
       run_bsd:
         description: "Build BSD"
         type: boolean
@@ -52,6 +56,7 @@ jobs:
     outputs:
       tag: ${{ steps.tag.outputs.value }}
       version: ${{ steps.tag.outputs.version }}
+      clean_version: ${{ steps.tag.outputs.clean_version }}
       prerelease: ${{ steps.tag.outputs.prerelease }}
     steps:
       - name: Resolve tag
@@ -63,33 +68,51 @@ jobs:
             TAG="${GITHUB_REF_NAME}"
           fi
           VERSION="${TAG#v}"
+          CLEAN_VERSION="${VERSION%-dev}"
           [[ "$TAG" == *"-"* ]] && PRERELEASE="true" || PRERELEASE="false"
           echo "value=${TAG}"             >> "$GITHUB_OUTPUT"
           echo "version=${VERSION}"       >> "$GITHUB_OUTPUT"
+          echo "clean_version=${CLEAN_VERSION}" >> "$GITHUB_OUTPUT"
           echo "prerelease=${PRERELEASE}" >> "$GITHUB_OUTPUT"
 
   # ── Release Notes ──────────────────────────────────────────────────────────
   notes:
     needs: setup
     runs-on: ubuntu-latest
+    outputs:
+      release_name: ${{ steps.extract.outputs.release_name }}
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ needs.setup.outputs.tag }}
 
       - name: Prepare Release Notes
+        id: extract
         shell: bash
         run: |
           set -euo pipefail
           tag="${{ needs.setup.outputs.version }}"
           notes_file=".github/release-notes.md"
           if grep -q "^## \\[${tag}\\]" CHANGELOG.md; then
+            # Extract release name from header: ## [0.7.1] - 2026-06-02 "Title"
+            release_name=$(awk -v ver="$tag" '
+              $0 ~ "^## \\[" ver "\\]" {
+                match($0, /"([^"]+)"/, arr)
+                if (arr[1] != "") {
+                  print "v" ver " - " arr[1]
+                } else {
+                  print "v" ver
+                }
+              }
+            ' CHANGELOG.md)
+            echo "release_name=${release_name}" >> "$GITHUB_OUTPUT"
             awk -v ver="$tag" '
               $0 ~ "^## \\[" ver "\\]" {found=1; next}
               found && $0 ~ "^## \\[" {exit}
               found {print}
             ' CHANGELOG.md | sed -e '${/^$/d;}' > "$notes_file"
           else
+            echo "release_name=v${tag}" >> "$GITHUB_OUTPUT"
             echo "No CHANGELOG section for $tag." > "$notes_file"
             git log -1 --pretty=format:"%s%n%n%b" >> "$notes_file"
           fi
@@ -115,6 +138,37 @@ jobs:
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.setup.outputs.tag }}
+          name: ${{ needs.notes.outputs.release_name }}
+          body_path: .github/release-notes.md
+          prerelease: ${{ needs.setup.outputs.prerelease == 'true' }}
+
+  # ── Man Pages Archive ──────────────────────────────────────────────────────
+  man-pages:
+    if: ${{ github.event_name == 'push' || github.event.inputs.run_linux == 'true' }}
+    needs: [setup, notes, create-release]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.setup.outputs.tag }}
+
+      - name: Download Release Notes
+        uses: actions/download-artifact@v4
+        with:
+          name: release-notes
+          path: .github
+
+      - name: Create Man Pages Archive
+        run: |
+          tar czf "dcr-man-pages-${{ needs.setup.outputs.version }}.tar.gz" \
+            --transform 's/^man\/man1\//usr\/share\/man\/man1\//' \
+            man/man1/*.1
+
+      - name: Upload Man Pages to Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ needs.setup.outputs.tag }}
+          files: dcr-man-pages-${{ needs.setup.outputs.version }}.tar.gz
           body_path: .github/release-notes.md
           prerelease: ${{ needs.setup.outputs.prerelease == 'true' }}
 
@@ -131,6 +185,12 @@ jobs:
           - target: aarch64-unknown-linux-gnu
           - target: x86_64-unknown-linux-musl
           - target: aarch64-unknown-linux-musl
+          - target: i686-unknown-linux-gnu
+          - target: i686-unknown-linux-musl
+          - target: armv7-unknown-linux-gnueabihf
+          - target: armv7-unknown-linux-musleabihf
+          - target: riscv64gc-unknown-linux-gnu
+          - target: riscv64gc-unknown-linux-musl
     steps:
       - uses: actions/checkout@v4
         with:
@@ -188,41 +248,73 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        include:
-          - package_type: deb
-            artifact_name: debian-package
-          - package_type: rpm
-            artifact_name: rpm-package
+        package_type: [deb, rpm, arch, snap]
+        target: [x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu, i686-unknown-linux-gnu, armv7-unknown-linux-gnueabihf, riscv64gc-unknown-linux-gnu]
+        exclude:
           - package_type: arch
-            artifact_name: arch-package
+            target: aarch64-unknown-linux-gnu
+          - package_type: arch
+            target: i686-unknown-linux-gnu
+          - package_type: arch
+            target: armv7-unknown-linux-gnueabihf
+          - package_type: arch
+            target: riscv64gc-unknown-linux-gnu
           - package_type: snap
-            artifact_name: snap-package
+            target: aarch64-unknown-linux-gnu
+          - package_type: snap
+            target: i686-unknown-linux-gnu
+          - package_type: snap
+            target: armv7-unknown-linux-gnueabihf
+          - package_type: snap
+            target: riscv64gc-unknown-linux-gnu
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ needs.setup.outputs.tag }}
 
-      - name: Setup Rust (For non-container builds)
+      - name: Install cargo-zigbuild
+        if: matrix.package_type == 'deb' || matrix.package_type == 'rpm'
+        run: |
+          pip install cargo-zigbuild
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Setup Zig
+        if: (matrix.package_type == 'deb' || matrix.package_type == 'rpm') && matrix.target != 'x86_64-unknown-linux-gnu'
+        uses: mlugg/setup-zig@v1
+        with:
+          version: 0.13.0
+
+      - name: Setup Rust
         if: matrix.package_type != 'arch'
         uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
 
       # ── DEB Build ──
       - name: Build Debian Package
         if: matrix.package_type == 'deb'
         run: |
           cargo install cargo-deb
-          cargo build --release
-          cargo deb --no-build
-          mkdir -p dist-packages && cp target/debian/*.deb dist-packages/
+          if [ "${{ matrix.target }}" != "x86_64-unknown-linux-gnu" ]; then
+            cargo zigbuild --release --target ${{ matrix.target }}
+          else
+            cargo build --release --target ${{ matrix.target }}
+          fi
+          cargo deb --no-build --target ${{ matrix.target }}
+          mkdir -p dist-packages && cp target/${{ matrix.target }}/debian/*.deb dist-packages/
 
       # ── RPM Build ──
       - name: Build RPM Package
         if: matrix.package_type == 'rpm'
         run: |
           cargo install cargo-generate-rpm
-          cargo build --release
-          cargo generate-rpm
-          mkdir -p dist-packages && cp target/generate-rpm/*.rpm dist-packages/
+          if [ "${{ matrix.target }}" != "x86_64-unknown-linux-gnu" ]; then
+            cargo zigbuild --release --target ${{ matrix.target }}
+          else
+            cargo build --release --target ${{ matrix.target }}
+          fi
+          cargo generate-rpm --target ${{ matrix.target }}
+          mkdir -p dist-packages && cp target/${{ matrix.target }}/generate-rpm/*.rpm dist-packages/
 
       # ── Snap Build ──
       - name: Build Snap Package
@@ -231,6 +323,7 @@ jobs:
           cargo build --release
           mkdir -p packaging/snap/dist/bin
           cp target/release/dcr packaging/snap/dist/bin/
+          cp -r man packaging/snap/dist/man
 
       - name: Snapcraft Build Action
         if: matrix.package_type == 'snap'
@@ -267,12 +360,17 @@ jobs:
           sha256sums=('${SHA256}')
           build() {
             cd "\$srcdir/\$pkgname-${PKGVER_ORIG}"
+            unset CFLAGS CXXFLAGS LDFLAGS
+            export RUSTFLAGS="-C linker=cc"
             cargo build --release --locked
           }
           package() {
-            cd "\$srcdir/\$pkgname-${PKGVER_ORIG}"
+            cd "\$srcdir/dcr-${PKGVER_ORIG}"
             install -Dm755 "target/release/dcr" "\$pkgdir/usr/bin/dcr"
             install -Dm644 LICENSE "\$pkgdir/usr/share/licenses/\$pkgname/LICENSE"
+            for manpage in man/man1/*.1; do
+              install -Dm644 "\$manpage" "\$pkgdir/usr/share/man/man1/\$(basename "\$manpage")"
+            done
           }
           PKG
           docker run --rm \
@@ -292,7 +390,7 @@ jobs:
       - name: Upload Package Artifact
         uses: actions/upload-artifact@v4
         with:
-          name: ${{ matrix.artifact_name }}
+          name: ${{ matrix.package_type }}-package-${{ matrix.target }}
           path: dist-packages/*
           if-no-files-found: ignore
 
@@ -317,10 +415,10 @@ jobs:
         with:
           tag_name: ${{ needs.setup.outputs.tag }}
           files: |
-            collected-packages/debian-package/*
-            collected-packages/rpm-package/*
-            collected-packages/arch-package/*
-            collected-packages/snap-package/*
+            collected-packages/deb-package-*/*
+            collected-packages/rpm-package-*/*
+            collected-packages/arch-package-*/*
+            collected-packages/snap-package-*/*
           body_path: .github/release-notes.md
           prerelease: ${{ needs.setup.outputs.prerelease == 'true' }}
 
@@ -446,8 +544,6 @@ jobs:
           cp target/release/dcr "$ASSET"
           echo "BSD_ASSET=${ASSET}" >> "$GITHUB_ENV"
 
-
-
       # --- UPLOAD TARGET ---
       - name: Upload BSD Asset to Release
         uses: softprops/action-gh-release@v2
@@ -468,6 +564,7 @@ jobs:
         include:
           - target: x86_64-pc-windows-msvc
           - target: aarch64-pc-windows-msvc
+          - target: i686-pc-windows-msvc
           - target: x86_64-pc-windows-gnu
     steps:
       - uses: actions/checkout@v4
@@ -548,14 +645,13 @@ jobs:
             'gcc: build C/C++ projects with GCC'
             'clang: build C/C++ projects with Clang'
           )
-          source=("\$pkgname-\$pkgver.tar.gz::\${SRC_URL}")
+          source=("\$pkgname-\$pkgver.tar.gz::${SRC_URL}")
           sha256sums=('${SHA256}')
 
           build() {
             cd "\$srcdir/\$pkgname-${PKGVER_ORIG}"
-            export CARGO_PROFILE_RELEASE_LTO=false
-            export RUSTFLAGS="\${RUSTFLAGS:-}"
-            export RUSTFLAGS="\${RUSTFLAGS/-C link-arg=-fuse-ld=lld/}"
+            unset CFLAGS CXXFLAGS LDFLAGS
+            export RUSTFLAGS="-C linker=cc"
             cargo build --release --locked
           }
 
@@ -563,6 +659,9 @@ jobs:
             cd "\$srcdir/\$pkgname-${PKGVER_ORIG}"
             install -Dm755 "target/release/dcr" "\$pkgdir/usr/bin/dcr"
             install -Dm644 LICENSE "\$pkgdir/usr/share/licenses/\$pkgname/LICENSE"
+            for manpage in man/man1/*.1; do
+              install -Dm644 "\$manpage" "\$pkgdir/usr/share/man/man1/\$(basename "\$manpage")"
+            done
           }
           PKG
 
@@ -599,22 +698,31 @@ jobs:
           ssh-keyscan aur.archlinux.org >> ~/.ssh/known_hosts
 
           export GIT_SSH_COMMAND='ssh -i ~/.ssh/aur -o IdentitiesOnly=yes'
-          git clone "ssh://aur@aur.archlinux.org/${AUR_PACKAGE}.git" aur-repo
-          cp packages/aur/dcr/PKGBUILD aur-repo/PKGBUILD
-          cp packages/aur/dcr/.SRCINFO aur-repo/.SRCINFO
-
+          
+          mkdir -p aur-repo
           cd aur-repo
+          git init
+          git remote add origin "ssh://aur@aur.archlinux.org/${AUR_PACKAGE}.git"
+          
+          git fetch origin master || true
+          git checkout master || git checkout -b master
+          
+          cp ../packages/aur/dcr/PKGBUILD .
+          cp ../packages/aur/dcr/.SRCINFO .
+
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
-          if git diff --quiet; then
-            echo "No AUR changes"
-            exit 0
+          if git rev-parse --verify HEAD >/dev/null 2>&1; then
+            if git diff --quiet; then
+              echo "No AUR changes"
+              exit 0
+            fi
           fi
 
           git add PKGBUILD .SRCINFO
           git commit -m "dcr ${{ needs.setup.outputs.version }}"
-          git push
+          git push -u origin master
 
   # ── Arch User Repository (dcr-bin) ────────────────────────────────
   publish-aur-bin:
@@ -631,10 +739,22 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
-          BIN_URL="https://github.com/dexoron/dcr/releases/download/${{ needs.setup.outputs.tag }}/dcr-x86_64-unknown-linux-musl-${{ needs.setup.outputs.version }}"
-          SHA256="$(curl -fsSL "$BIN_URL" | sha256sum | awk '{print $1}')"
-          echo "bin_url=$BIN_URL" >> "$GITHUB_OUTPUT"
-          echo "sha256=$SHA256" >> "$GITHUB_OUTPUT"
+          TAG="${{ needs.setup.outputs.tag }}"
+          VER="${{ needs.setup.outputs.version }}"
+          BASE_URL="https://github.com/dexoron/dcr/releases/download/${TAG}"
+          for arch in x86_64 aarch64 i686 armv7h riscv64; do
+            case "$arch" in
+              x86_64)  triple="x86_64-unknown-linux-musl" ;;
+              aarch64) triple="aarch64-unknown-linux-musl" ;;
+              i686)    triple="i686-unknown-linux-musl" ;;
+              armv7h)  triple="armv7-unknown-linux-musleabihf" ;;
+              riscv64) triple="riscv64gc-unknown-linux-musl" ;;
+            esac
+            url="${BASE_URL}/dcr-${triple}-${VER}"
+            sha256="$(curl -fsSL "$url" | sha256sum | awk '{print $1}')"
+            echo "${arch}_url=${url}" >> "$GITHUB_OUTPUT"
+            echo "${arch}_sha256=${sha256}" >> "$GITHUB_OUTPUT"
+          done
 
       - name: Render AUR Metadata
         shell: bash
@@ -642,16 +762,13 @@ jobs:
           set -euo pipefail
           PKGVER_ORIG='${{ needs.setup.outputs.version }}'
           PKGVER_CLEAN="${PKGVER_ORIG//-/.}"
-          BIN_URL='${{ steps.meta.outputs.bin_url }}'
-          SHA256='${{ steps.meta.outputs.sha256 }}'
-
           mkdir -p packages/aur/dcr-bin
           cat > packages/aur/dcr-bin/PKGBUILD <<PKG
           pkgname=dcr-bin
           pkgver=${PKGVER_CLEAN}
           pkgrel=1
           pkgdesc="Cargo-like utility to manage C/C++ projects (pre-compiled musl binary)"
-          arch=('x86_64')
+          arch=('x86_64' 'aarch64' 'i686' 'armv7h' 'riscv64')
           url="https://github.com/dexoron/dcr"
           license=('GPL-3.0-or-later')
           provides=('dcr')
@@ -660,8 +777,16 @@ jobs:
             'gcc: build C/C++ projects with GCC'
             'clang: build C/C++ projects with Clang'
           )
-          source_x86_64=("dcr-\$pkgver::${BIN_URL}")
-          sha256sums_x86_64=('${SHA256}')
+          source_x86_64=("dcr-\$pkgver::${{ steps.meta.outputs.x86_64_url }}")
+          sha256sums_x86_64=('${{ steps.meta.outputs.x86_64_sha256 }}')
+          source_aarch64=("dcr-\$pkgver::${{ steps.meta.outputs.aarch64_url }}")
+          sha256sums_aarch64=('${{ steps.meta.outputs.aarch64_sha256 }}')
+          source_i686=("dcr-\$pkgver::${{ steps.meta.outputs.i686_url }}")
+          sha256sums_i686=('${{ steps.meta.outputs.i686_sha256 }}')
+          source_armv7h=("dcr-\$pkgver::${{ steps.meta.outputs.armv7h_url }}")
+          sha256sums_armv7h=('${{ steps.meta.outputs.armv7h_sha256 }}')
+          source_riscv64=("dcr-\$pkgver::${{ steps.meta.outputs.riscv64_url }}")
+          sha256sums_riscv64=('${{ steps.meta.outputs.riscv64_sha256 }}')
 
           package() {
             install -Dm755 "\$srcdir/dcr-\$pkgver" "\$pkgdir/usr/bin/dcr"
@@ -675,13 +800,25 @@ jobs:
             pkgrel = 1
             url = https://github.com/dexoron/dcr
             arch = x86_64
+            arch = aarch64
+            arch = i686
+            arch = armv7h
+            arch = riscv64
             license = GPL-3.0-or-later
             provides = dcr
             conflicts = dcr
             optdepends = gcc: build C/C++ projects with GCC
             optdepends = clang: build C/C++ projects with Clang
-            source_x86_64 = dcr-${PKGVER_CLEAN}::${BIN_URL}
-            sha256sums_x86_64 = ${SHA256}
+            source_x86_64 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.x86_64_url }}
+            sha256sums_x86_64 = ${{ steps.meta.outputs.x86_64_sha256 }}
+            source_aarch64 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.aarch64_url }}
+            sha256sums_aarch64 = ${{ steps.meta.outputs.aarch64_sha256 }}
+            source_i686 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.i686_url }}
+            sha256sums_i686 = ${{ steps.meta.outputs.i686_sha256 }}
+            source_armv7h = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.armv7h_url }}
+            sha256sums_armv7h = ${{ steps.meta.outputs.armv7h_sha256 }}
+            source_riscv64 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.riscv64_url }}
+            sha256sums_riscv64 = ${{ steps.meta.outputs.riscv64_sha256 }}
 
           pkgname = dcr-bin
           SRC
@@ -699,22 +836,299 @@ jobs:
           ssh-keyscan aur.archlinux.org >> ~/.ssh/known_hosts
 
           export GIT_SSH_COMMAND='ssh -i ~/.ssh/aur -o IdentitiesOnly=yes'
-          git clone "ssh://aur@aur.archlinux.org/${AUR_PACKAGE}.git" aur-repo
-          cp packages/aur/dcr-bin/PKGBUILD aur-repo/PKGBUILD
-          cp packages/aur/dcr-bin/.SRCINFO aur-repo/.SRCINFO
-
+          
+          mkdir -p aur-repo
           cd aur-repo
+          git init
+          git remote add origin "ssh://aur@aur.archlinux.org/${AUR_PACKAGE}.git"
+          
+          git fetch origin master || true
+          git checkout master || git checkout -b master
+          
+          cp ../packages/aur/dcr-bin/PKGBUILD .
+          cp ../packages/aur/dcr-bin/.SRCINFO .
+
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
-          if git diff --quiet; then
-            echo "No AUR changes"
-            exit 0
+          if git rev-parse --verify HEAD >/dev/null 2>&1; then
+            if git diff --quiet; then
+              echo "No AUR changes"
+              exit 0
+            fi
           fi
 
           git add PKGBUILD .SRCINFO
           git commit -m "dcr-bin ${{ needs.setup.outputs.version }}"
-          git push
+          git push -u origin master
+
+
+  # ── Arch User Repository (dcr-dev) ────────────────────────────────
+  publish-aur-dev:
+    if: ${{ (github.event_name == 'push' && needs.setup.outputs.prerelease == 'true') || github.event.inputs.run_aur_dev == 'true' }}
+    needs: [setup]
+    runs-on: ubuntu-latest
+    environment: aur
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Derive checksum
+        id: meta
+        shell: bash
+        run: |
+          set -euo pipefail
+          SRC_URL="https://github.com/dexoron/dcr/archive/refs/tags/${{ needs.setup.outputs.tag }}.tar.gz"
+          SHA256="$(curl -fsSL "$SRC_URL" | sha256sum | awk '{print $1}')"
+          echo "source_url=$SRC_URL" >> "$GITHUB_OUTPUT"
+          echo "sha256=$SHA256" >> "$GITHUB_OUTPUT"
+
+      - name: Render AUR metadata
+        shell: bash
+        run: |
+          set -euo pipefail
+          PKGVER_ORIG='${{ needs.setup.outputs.version }}'
+          PKGVER_CLEAN='${{ needs.setup.outputs.clean_version }}'
+          SRC_URL='${{ steps.meta.outputs.source_url }}'
+          SHA256='${{ steps.meta.outputs.sha256 }}'
+
+          mkdir -p packages/aur/dcr-dev
+          cat > packages/aur/dcr-dev/PKGBUILD <<PKG
+          pkgname=dcr-dev
+          pkgver=${PKGVER_CLEAN}
+          pkgrel=1
+          pkgdesc="Cargo-like utility to manage C/C++ projects (development release)"
+          arch=('x86_64' 'aarch64')
+          url="https://github.com/dexoron/dcr"
+          license=('GPL-3.0-or-later')
+          depends=('gcc-libs')
+          makedepends=('cargo')
+          options=('!lto')
+          provides=('dcr')
+          conflicts=('dcr')
+          optdepends=(
+            'gcc: build C/C++ projects with GCC'
+            'clang: build C/C++ projects with Clang'
+          )
+          source=("\$pkgname-\$pkgver.tar.gz::${SRC_URL}")
+          sha256sums=('${SHA256}')
+
+          build() {
+            cd "\$srcdir/dcr-${PKGVER_ORIG}"
+            unset CFLAGS CXXFLAGS LDFLAGS
+            export RUSTFLAGS="-C linker=cc"
+            cargo build --release --locked
+          }
+
+          package() {
+            cd "\$srcdir/\$pkgname-${PKGVER_ORIG}"
+            install -Dm755 "target/release/dcr" "\$pkgdir/usr/bin/dcr"
+            install -Dm644 LICENSE "\$pkgdir/usr/share/licenses/\$pkgname/LICENSE"
+            for manpage in man/man1/*.1; do
+              install -Dm644 "\$manpage" "\$pkgdir/usr/share/man/man1/\$(basename "\$manpage")"
+            done
+          }
+          PKG
+
+          cat > packages/aur/dcr-dev/.SRCINFO <<SRC
+          pkgbase = dcr-dev
+            pkgdesc = Cargo-like utility to manage C/C++ projects (development release)
+            pkgver = ${PKGVER_CLEAN}
+            pkgrel = 1
+            url = https://github.com/dexoron/dcr
+            arch = x86_64
+            arch = aarch64
+            license = GPL-3.0-or-later
+            makedepends = cargo
+            depends = gcc-libs
+            provides = dcr
+            conflicts = dcr
+            optdepends = gcc: build C/C++ projects with GCC
+            optdepends = clang: build C/C++ projects with Clang
+            options = !lto
+            source = dcr-${PKGVER_CLEAN}.tar.gz::${SRC_URL}
+            sha256sums = ${SHA256}
+
+          pkgname = dcr-dev
+          SRC
+
+      - name: Push to AUR
+        env:
+          AUR_SSH_PRIVATE_KEY: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
+          AUR_PACKAGE: dcr-dev
+        shell: bash
+        run: |
+          set -euo pipefail
+          install -d -m 700 ~/.ssh
+          printf '%s\n' "$AUR_SSH_PRIVATE_KEY" > ~/.ssh/aur
+          chmod 600 ~/.ssh/aur
+          ssh-keyscan aur.archlinux.org >> ~/.ssh/known_hosts
+
+          export GIT_SSH_COMMAND='ssh -i ~/.ssh/aur -o IdentitiesOnly=yes'
+          
+          mkdir -p aur-repo
+          cd aur-repo
+          git init
+          git remote add origin "ssh://aur@aur.archlinux.org/${AUR_PACKAGE}.git"
+          
+          git fetch origin master || true
+          git checkout master || git checkout -b master
+          
+          cp ../packages/aur/dcr-dev/PKGBUILD .
+          cp ../packages/aur/dcr-dev/.SRCINFO .
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          if git rev-parse --verify HEAD >/dev/null 2>&1; then
+            if git diff --quiet; then
+              echo "No AUR changes"
+              exit 0
+            fi
+          fi
+
+          git add PKGBUILD .SRCINFO
+          git commit -m "dcr-dev ${{ needs.setup.outputs.version }}"
+          git push -u origin master
+
+  # ── Arch User Repository (dcr-dev-bin) ────────────────────────────
+  publish-aur-dev-bin:
+    if: ${{ (github.event_name == 'push' && needs.setup.outputs.prerelease == 'true') || github.event.inputs.run_aur_dev == 'true' }}
+    needs: [setup, build-linux]
+    runs-on: ubuntu-latest
+    environment: aur
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Derive checksum
+        id: meta
+        shell: bash
+        run: |
+          set -euo pipefail
+          TAG="${{ needs.setup.outputs.tag }}"
+          VER="${{ needs.setup.outputs.version }}"
+          BASE_URL="https://github.com/dexoron/dcr/releases/download/${TAG}"
+          for arch in x86_64 aarch64 i686 armv7h riscv64; do
+            case "$arch" in
+              x86_64)  triple="x86_64-unknown-linux-musl" ;;
+              aarch64) triple="aarch64-unknown-linux-musl" ;;
+              i686)    triple="i686-unknown-linux-musl" ;;
+              armv7h)  triple="armv7-unknown-linux-musleabihf" ;;
+              riscv64) triple="riscv64gc-unknown-linux-musl" ;;
+            esac
+            url="${BASE_URL}/dcr-${triple}-${VER}"
+            sha256="$(curl -fsSL "$url" | sha256sum | awk '{print $1}')"
+            echo "${arch}_url=${url}" >> "$GITHUB_OUTPUT"
+            echo "${arch}_sha256=${sha256}" >> "$GITHUB_OUTPUT"
+          done
+
+      - name: Render AUR Metadata
+        shell: bash
+        run: |
+          set -euo pipefail
+          PKGVER_ORIG='${{ needs.setup.outputs.version }}'
+          PKGVER_CLEAN='${{ needs.setup.outputs.clean_version }}'
+          mkdir -p packages/aur/dcr-dev-bin
+          cat > packages/aur/dcr-dev-bin/PKGBUILD <<PKG
+          pkgname=dcr-dev-bin
+          pkgver=${PKGVER_CLEAN}
+          pkgrel=1
+          pkgdesc="Cargo-like utility to manage C/C++ projects (pre-compiled musl binary dev release)"
+          arch=('x86_64' 'aarch64' 'i686' 'armv7h' 'riscv64')
+          url="https://github.com/dexoron/dcr"
+          license=('GPL-3.0-or-later')
+          provides=('dcr')
+          conflicts=('dcr')
+          optdepends=(
+            'gcc: build C/C++ projects with GCC'
+            'clang: build C/C++ projects with Clang'
+          )
+          source_x86_64=("dcr-\$pkgver::${{ steps.meta.outputs.x86_64_url }}")
+          sha256sums_x86_64=('${{ steps.meta.outputs.x86_64_sha256 }}')
+          source_aarch64=("dcr-\$pkgver::${{ steps.meta.outputs.aarch64_url }}")
+          sha256sums_aarch64=('${{ steps.meta.outputs.aarch64_sha256 }}')
+          source_i686=("dcr-\$pkgver::${{ steps.meta.outputs.i686_url }}")
+          sha256sums_i686=('${{ steps.meta.outputs.i686_sha256 }}')
+          source_armv7h=("dcr-\$pkgver::${{ steps.meta.outputs.armv7h_url }}")
+          sha256sums_armv7h=('${{ steps.meta.outputs.armv7h_sha256 }}')
+          source_riscv64=("dcr-\$pkgver::${{ steps.meta.outputs.riscv64_url }}")
+          sha256sums_riscv64=('${{ steps.meta.outputs.riscv64_sha256 }}')
+
+          package() {
+            install -Dm755 "\$srcdir/dcr-\$pkgver" "\$pkgdir/usr/bin/dcr"
+          }
+          PKG
+
+          cat > packages/aur/dcr-dev-bin/.SRCINFO <<SRC
+          pkgbase = dcr-dev-bin
+            pkgdesc = Cargo-like utility to manage C/C++ projects (pre-compiled musl binary dev release)
+            pkgver = ${PKGVER_CLEAN}
+            pkgrel = 1
+            url = https://github.com/dexoron/dcr
+            arch = x86_64
+            arch = aarch64
+            arch = i686
+            arch = armv7h
+            arch = riscv64
+            license = GPL-3.0-or-later
+            provides = dcr
+            conflicts = dcr
+            optdepends = gcc: build C/C++ projects with GCC
+            optdepends = clang: build C/C++ projects with Clang
+            source_x86_64 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.x86_64_url }}
+            sha256sums_x86_64 = ${{ steps.meta.outputs.x86_64_sha256 }}
+            source_aarch64 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.aarch64_url }}
+            sha256sums_aarch64 = ${{ steps.meta.outputs.aarch64_sha256 }}
+            source_i686 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.i686_url }}
+            sha256sums_i686 = ${{ steps.meta.outputs.i686_sha256 }}
+            source_armv7h = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.armv7h_url }}
+            sha256sums_armv7h = ${{ steps.meta.outputs.armv7h_sha256 }}
+            source_riscv64 = dcr-${PKGVER_CLEAN}::${{ steps.meta.outputs.riscv64_url }}
+            sha256sums_riscv64 = ${{ steps.meta.outputs.riscv64_sha256 }}
+
+          pkgname = dcr-dev-bin
+          SRC
+
+      - name: Push to AUR
+        env:
+          AUR_SSH_PRIVATE_KEY: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
+          AUR_PACKAGE: dcr-dev-bin
+        shell: bash
+        run: |
+          set -euo pipefail
+          install -d -m 700 ~/.ssh
+          printf '%s\n' "$AUR_SSH_PRIVATE_KEY" > ~/.ssh/aur
+          chmod 600 ~/.ssh/aur
+          ssh-keyscan aur.archlinux.org >> ~/.ssh/known_hosts
+
+          export GIT_SSH_COMMAND='ssh -i ~/.ssh/aur -o IdentitiesOnly=yes'
+          
+          mkdir -p aur-repo
+          cd aur-repo
+          git init
+          git remote add origin "ssh://aur@aur.archlinux.org/${AUR_PACKAGE}.git"
+          
+          git fetch origin master || true
+          git checkout master || git checkout -b master
+          
+          cp ../packages/aur/dcr-dev-bin/PKGBUILD .
+          cp ../packages/aur/dcr-dev-bin/.SRCINFO .
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          if git rev-parse --verify HEAD >/dev/null 2>&1; then
+            if git diff --quiet; then
+              echo "No AUR changes"
+              exit 0
+            fi
+          fi
+
+          git add PKGBUILD .SRCINFO
+          git commit -m "dcr-dev-bin ${{ needs.setup.outputs.version }}"
+          git push -u origin master
+
 
   # ── crates.io ──────────────────────────────────────────────────────────────
   publish-crates:
@@ -734,6 +1148,8 @@ jobs:
       - uses: dtolnay/rust-toolchain@stable
 
       - name: Publish to crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
         run: cargo publish
 
   # ── Homebrew tap ───────────────────────────────────────────────────────────
@@ -758,6 +1174,7 @@ jobs:
           echo "linux_arm=$(download_sha "dcr-aarch64-unknown-linux-gnu-${VERSION}")"    >> "$GITHUB_OUTPUT"
           echo "macos_x86=$(download_sha "dcr-x86_64-apple-darwin-${VERSION}")"          >> "$GITHUB_OUTPUT"
           echo "macos_arm=$(download_sha "dcr-aarch64-apple-darwin-${VERSION}")"         >> "$GITHUB_OUTPUT"
+          echo "man_pages=$(download_sha "dcr-man-pages-${VERSION}.tar.gz")"             >> "$GITHUB_OUTPUT"
 
       - name: Checkout homebrew-dexoron
         uses: actions/checkout@v4
@@ -800,6 +1217,18 @@ jobs:
               bin.install Dir["dcr*"].first => "dcr"
             end
 
+            resource "man-pages" do
+              url "https://github.com/dexoron/dcr/releases/download/v#{version}/dcr-man-pages-#{version}.tar.gz"
+              sha256 "${{ steps.sha.outputs.man_pages }}"
+            end
+
+            def install
+              bin.install Dir["dcr*"].first => "dcr"
+              resource("man-pages").stage do
+                man1.install Dir["usr/share/man/man1/*.1"]
+              end
+            end
+
             test do
               system "#{bin}/dcr", "--version"
             end
@@ -813,4 +1242,13 @@ jobs:
           git add Formula/dcr.rb
           git diff --staged --quiet && echo "No changes" && exit 0
           git commit -m "dcr ${{ needs.setup.outputs.version }}"
-          git push
+          git push
+  
+  # ── Snap Store (dcrup) — temporarily disabled ────────────────────────────
+  # Classic confinement was denied for this project (too new).
+  # Snap artifact is still built and attached to the release via
+  # publish-dexoron-packages. Users can install manually:
+  #   sudo snap install --classic --dangerous dcrup_*.snap
+  #
+  # publish-snap:
+  #   if: ...

.gitignore

@@ -2,6 +2,7 @@ target/
 sandbox/**
 .idea/
 .vscode/
+.cargo/
 .env
 
 personal/

CHANGELOG.md

@@ -1,6 +1,122 @@
 # Changelog
 
-## [0.7.0] - 2026-05-30
+## [0.7.3] - 2026-06-13 "Оптимизация Зависимостей и VCS / Dependency Optimization & VCS"
+
+### RU
+
+**Добавлено:**
+
+- **Параметр `--vcs` для команд `new` и `init`** — добавлена возможность явно указывать систему контроля версий через `--vcs <git|none>`.
+- **Интеграция Git-информации в `--version`** — утилита теперь выводит текущий короткий хэш коммита и суффикс `-dirty`, если в репозитории DCR есть незакоммиченные изменения.
+- **Автоматическая генерация `.gitignore`** — при инициализации Git-репозитория автоматически создается файл `.gitignore` с исключением директории `/target`.
+- **Защита от вложенных репозиториев** — автоматическая инициализация Git теперь пропускается, если `dcr new` или `dcr init` запускаются внутри уже существующего Git-репозитория.
+- **Тесты для верификации VCS** — добавлены интеграционные тесты `new_vcs_options_work` и `init_vcs_options_work` для проверки логики инициализации репозиториев.
+
+**Изменено:**
+
+- **Полный отказ от библиотеки `git2`** — работа с Git (клонирование зависимостей, инициализация VCS, проверка статуса) переведена на вызовы системного `git` через `Command`. Это облегчает сборку проекта и убирает необходимость в фичах `vendored` и `openssl`.
+- **Миграция с `reqwest` на `ureq`** — в модуле обновления (`flag_update.rs`) тяжелый `reqwest` заменен на легковесный синхронный клиент `ureq 2.10`, что уменьшило оверхед и размер итогового бинарника.
+
+### EN
+
+**Added:**
+
+- **`--vcs` option for `new` and `init` commands** — introduced explicit version control system selection via `--vcs <git|none>`.
+- **Git metadata integration in `--version`** — the CLI now appends the current short commit hash and a `-dirty` suffix if there are uncommitted changes in the DCR repository.
+- **Automatic `.gitignore` generation** — Git repository initialization now automatically writes a `.gitignore` file excluding the `/target` directory.
+- **Nested repository prevention** — automatic Git initialization is now skipped if `dcr new` or `dcr init` is executed inside an already existing Git repository.
+- **VCS verification tests** — added `new_vcs_options_work` and `init_vcs_options_work` integration tests to ensure reliable repository behavior.
+
+**Changed:**
+
+- **Complete removal of `git2` dependency** — all Git actions (dependency fetching, VCS setup, status checks) are now delegated to the system `git` executable via `Command`. This simplifies compilation and drops the need for `vendored` and `openssl` features.
+- **Migrated from `reqwest` to `ureq`** — replaced the heavy `reqwest` crate in `flag_update.rs` with the lightweight synchronous `ureq 2.10` client, reducing overhead and the final binary size.
+
+## [0.7.2] - 2026-06-07 "Исправление Таргетов и Линковки / Target & Linker Fixes"
+
+### RU
+
+**Добавлено:**
+- Учтён `target_env` в `default_target_triple()` — Linux (gnu/musl) и Windows (msvc/gnu) теперь используют правильное окружение, а не хардкод.
+
+**Исправлено:**
+- **Сборка на macOS Apple Silicon падала с `_main` undefined** — `--target=` теперь передаётся и в ldflags, не только в cflags. `default_target_triple()` на macOS использует `std::env::consts::ARCH` вместо хардкода `x86_64`.
+- **Бейджи GitHub Stars и GPL-3.0 не рендерились в README** — блок бейджей переведён на чистый HTML.
+
+**Изменено:**
+- Вычисление таргета по умолчанию вынесено в общую функцию `default_target_triple()` — устранено дублирование в build, run, clean.
+
+### EN
+
+**Added:**
+- `default_target_triple()` now respects `target_env` — Linux (gnu/musl) and Windows (msvc/gnu) use the correct environment instead of hardcoded values.
+
+**Fixed:**
+- **macOS Apple Silicon builds failed with `_main` undefined** — `--target=` is now passed to ldflags, not just cflags. `default_target_triple()` uses `std::env::consts::ARCH` on macOS instead of hardcoded `x86_64`.
+- **GitHub Stars and GPL-3.0 badges not rendering in README** — badge block converted to pure HTML.
+
+**Changed:**
+- Default target resolution extracted into shared `default_target_triple()` — removed duplication across build, run, clean.
+
+## [0.7.1] - 2026-06-02 "Мультиархитектурное расширение / The Multi-Arch Expansion"
+
+### RU
+
+**Добавлено:**
+- Вывод `--help` для всех команд с цветным форматированием.
+- man-страницы (12 штук в `man/man1/`) и их установка во всех пакетах.
+- Валидация имен проектов в `dcr init` и `dcr new` (только ASCII буквы, цифры, `_` и `-`).
+- Метаданные `documentation` и `homepage` в `Cargo.toml`.
+- Оптимизация сборки: `opt-level = "z"`, LTO, `codegen-units = 1`, `panic = "abort"`, `strip = true`.
+- Поддержка новых архитектур (i686, armv7, riscv64gc, aarch64) в рабочих процессах и установочных скриптах.
+- Сборка пакетов `deb` и `rpm` для всех 5 архитектур Linux через `cargo-zigbuild`.
+- Пакеты AUR (`dcr-dev`, `dcr-dev-bin`) и сборка Snap в CI.
+
+**Изменено:**
+- Функция `validate_package_name` стала публичной.
+- Команды `gen`, `tree`, `fmt`, `setup` больше не игнорируют аргументы и используют цветной вывод.
+- Инструкция в README изменена с `| bash` на `| sh` для POSIX.
+- Отключена архитектура Windows 32-bit (GNU) из-за проблем со сборкой.
+
+**Исправлено:**
+
+- **`dcr new <invalid-name>` создаёт директорию, затем падает** — валидация теперь происходит до операций с файлами.
+- **`dcr init` создаёт dcr.toml, затем падает при невалидном имени директории** — то же исправление.
+- **Man-страницы отсутствовали после установки** — теперь устанавливаются через скрипты установки, пакетные менеджеры и Homebrew.
+- **Ложное срабатывание на букву диска в Windows** — в парсинге файлов зависимостей.
+- **CRLF `\r\n` ломает парсер зависимостей** — теперь обрабатываются смешанные окончания строк.
+- **Новая строка после обратного слеша не поглощалась** — в обработке escape-последовательностей `parse_d_file`.
+
+### EN
+
+**Added:**
+- `--help` for all commands with styled headers and usage lines.
+- Man pages (12 troff man pages in `man/man1/`) and their installation across all packaging formats.
+- Project name validation in `dcr init` and `dcr new` (ASCII letters, digits, `_`, `-` only).
+- `documentation` and `homepage` metadata in `Cargo.toml`.
+- Release profile optimizations (`opt-level = "z"`, LTO, `codegen-units = 1`, `panic = "abort"`, `strip = true`).
+- Linux i686, armv7, riscv64gc, aarch64 architecture support in release workflows and installation scripts.
+- Multi-arch `deb` and `rpm` package builds for all 5 Linux architectures via `cargo-zigbuild`.
+- AUR packages (`dcr-dev`, `dcr-dev-bin`) and Snap build in CI.
+
+**Changed:**
+- `validate_package_name` made public and callable from CLI commands directly.
+- `gen.rs`, `tree.rs`, `fmt.rs`, `setup.rs` no longer ignore arguments and use styled output.
+- README install instructions changed from `| bash` to `| sh` for POSIX compatibility.
+- Disabled Windows 32-bit (GNU) target due to build issues.
+
+Fixed:
+
+- **`dcr new <invalid-name>` creates directory then fails** — validation now happens
+  before any file operations.
+- **`dcr init` creates dcr.toml then fails on invalid directory name** — same fix.
+- **Man pages missing after installation** — now installed via install scripts,
+  package managers, and Homebrew.
+- **Windows drive letter false positive** — in dependency file parsing.
+- **CRLF `\r\n` breaks dependency parser** — now handles mixed line endings.
+- **Newline after backslash not consumed** — in `parse_d_file` escape handling.
+
+## [0.7.0] - 2026-06-02
 
 Added:
 
@@ -14,6 +130,8 @@ Added:
 - **Linux ARM64 support in `install.sh`** — added `Linux:aarch64|Linux:arm64` target triple detection for pre-built binary downloads.
 - **BSD OS detection in `install.sh`** — FreeBSD, OpenBSD, NetBSD detection and target triple resolution.
 - **`rust-toolchain.toml`** — explicit `stable` channel toolchain pinning.
+- **Nix support** — `flake.nix` for Nix package manager. Run via `nix run github:dexoron/dcr` or install with `nix profile install github:dexoron/dcr`. Contributed by community contributor.
+- **Snapcraft publish** — `dcrup` published on Snapcraft. Install with `sudo snap install dcrup`.
 - **Integration tests** — `build_with_target_config` (verifies `build.target = "linux"`) and `build_with_out_dir` (verifies custom output directory).
 - **`get_build_string_with_profile` made `pub`** — so `run.rs` can resolve custom output directory configuration.
 
@@ -25,7 +143,8 @@ Changed:
 - **`collect_sources()` returns empty vec** instead of error when no source files are found, allowing `kind = "none"` or `kind = "custom"` projects to have no source files.
 - **CI/CD release workflow refactored** — `git2` made target-specific (no vendored-openssl on Windows), Zig-based cross-compilation for non-x86_64 Linux targets, Arch Linux package version sanitization (dashes → dots), NetBSD `gmake` symlink.
 - **README compatibility table** — FreeBSD, OpenBSD, NetBSD build/runtime status upgraded from community/best-effort to officially supported.
-- **Documentation updated** — `build-section.md` documents new `build.target` and `build.out_dir` fields. `target-directory.md` rewritten to clarify the distinction.
+- **Documentation rewritten** — available at [dcr.dexoron.su/docs](https://dcr.dexoron.su/docs) or in the `docs/` directory. Installation guides, commands, and reference updated to reflect current CLI and config format.
+- **Site rewritten** — `dcr-site` migrated to Docusaurus with internationalization (i18n) support, improved navigation, and updated content across all sections.
 - **Dev channel dependency check in `install.sh`** — checks for `python3` or `jq` before attempting dev channel installations.
 
 Fixed:

Cargo.toml

@@ -1,11 +1,13 @@
 [package]
 name = "dcr"
-version = "0.7.0"
+version = "0.7.3"
 edition = "2024"
 build = "build.rs"
 description = "DCR is a utility for managing C/C++ projects in a Cargo-like style."
 license = "GPL-3.0-or-later"
 repository = "https://github.com/dexoron/dcr"
+documentation = "https://dcr.dexoron.su/docs"
+homepage = "https://dcr.dexoron.su"
 
 [package.metadata.binstall]
 pkg-fmt = "bin"
@@ -21,6 +23,18 @@ section = "devel"
 priority = "optional"
 assets = [
     ["target/release/dcr", "usr/bin/dcr", "755"],
+    ["man/man1/dcr.1", "usr/share/man/man1/dcr.1", "644"],
+    ["man/man1/dcr-add.1", "usr/share/man/man1/dcr-add.1", "644"],
+    ["man/man1/dcr-build.1", "usr/share/man/man1/dcr-build.1", "644"],
+    ["man/man1/dcr-clean.1", "usr/share/man/man1/dcr-clean.1", "644"],
+    ["man/man1/dcr-fmt.1", "usr/share/man/man1/dcr-fmt.1", "644"],
+    ["man/man1/dcr-gen.1", "usr/share/man/man1/dcr-gen.1", "644"],
+    ["man/man1/dcr-init.1", "usr/share/man/man1/dcr-init.1", "644"],
+    ["man/man1/dcr-new.1", "usr/share/man/man1/dcr-new.1", "644"],
+    ["man/man1/dcr-run.1", "usr/share/man/man1/dcr-run.1", "644"],
+    ["man/man1/dcr-setup.1", "usr/share/man/man1/dcr-setup.1", "644"],
+    ["man/man1/dcr-test.1", "usr/share/man/man1/dcr-test.1", "644"],
+    ["man/man1/dcr-tree.1", "usr/share/man/man1/dcr-tree.1", "644"],
 ]
 
 [package.metadata.generate-rpm]
@@ -30,12 +44,24 @@ Cargo-like utility to manage C/C++ projects.
 """
 
 assets = [
-    { source = "target/release/dcr", dest = "/usr/bin/dcr", mode = "755" }
+    { source = "target/release/dcr", dest = "/usr/bin/dcr", mode = "755" },
+    { source = "man/man1/dcr.1", dest = "/usr/share/man/man1/dcr.1", mode = "644" },
+    { source = "man/man1/dcr-add.1", dest = "/usr/share/man/man1/dcr-add.1", mode = "644" },
+    { source = "man/man1/dcr-build.1", dest = "/usr/share/man/man1/dcr-build.1", mode = "644" },
+    { source = "man/man1/dcr-clean.1", dest = "/usr/share/man/man1/dcr-clean.1", mode = "644" },
+    { source = "man/man1/dcr-fmt.1", dest = "/usr/share/man/man1/dcr-fmt.1", mode = "644" },
+    { source = "man/man1/dcr-gen.1", dest = "/usr/share/man/man1/dcr-gen.1", mode = "644" },
+    { source = "man/man1/dcr-init.1", dest = "/usr/share/man/man1/dcr-init.1", mode = "644" },
+    { source = "man/man1/dcr-new.1", dest = "/usr/share/man/man1/dcr-new.1", mode = "644" },
+    { source = "man/man1/dcr-run.1", dest = "/usr/share/man/man1/dcr-run.1", mode = "644" },
+    { source = "man/man1/dcr-setup.1", dest = "/usr/share/man/man1/dcr-setup.1", mode = "644" },
+    { source = "man/man1/dcr-test.1", dest = "/usr/share/man/man1/dcr-test.1", mode = "644" },
+    { source = "man/man1/dcr-tree.1", dest = "/usr/share/man/man1/dcr-tree.1", mode = "644" },
 ]
 
 [dependencies]
 glob = "0.3"
-reqwest = { version = "0.12", default-features = false, features = ["blocking", "json", "rustls-tls"] }
+ureq = { version = "2.10", default-features = false, features = ["json", "native-certs"] }
 serde = { version = "1", features = ["derive"] }
 self-replace = "1"
 sha2 = "0.10"
@@ -43,9 +69,17 @@ toml = "1.0.3"
 serde_json = "1"
 ctrlc = "3"
 
-[target.'cfg(not(windows))'.dependencies]
-git2 = { version = "0.20.4", features = ["vendored-libgit2", "vendored-openssl"] }
-openssl = { version = "0.10", features = ["vendored"] }
+[profile.release]
+opt-level = "z"
+lto = "thin"
+codegen-units = 1
+panic = "abort"
+strip = true
 
-[target.'cfg(windows)'.dependencies]
-git2 = { version = "0.20.4", features = ["vendored-libgit2"] }
+[profile.fast]
+inherits = "release"
+opt-level = 1
+lto = false
+codegen-units = 16
+panic = "abort"
+strip = true

README.md

@@ -1,31 +1,32 @@
-<div align="center">
+<h1 align="center">DCR — Dexoron Cargo Realization</h1>
 
-# DCR — Dexoron Cargo Realization
+<p align="center"><strong>A Cargo-style build tool for C/C++ projects</strong></p>
 
-**A Cargo-style build tool for C/C++ projects**
+<p align="center">
+  <a href="https://github.com/dexoron/dcr/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/dexoron/dcr/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/dexoron/dcr/releases/latest"><img alt="GitHub Release" src="https://img.shields.io/github/v/release/dexoron/dcr"></a>
+  <a href="https://github.com/dexoron/dcr/releases"><img alt="Platform" src="https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-lightgrey"></a>
+  <br>
+  <a href="https://aur.archlinux.org/packages/dcr"><img alt="AUR" src="https://img.shields.io/aur/version/dcr"></a>
+  <a href="https://crates.io/crates/dcr"><img alt="Crates.io" src="https://img.shields.io/crates/v/dcr"></a>
+  <a href="https://github.com/dexoron/homebrew-dexoron"><img alt="Homebrew" src="https://img.shields.io/badge/homebrew-dexoron%2Fdexoron-orange"></a>
+  <br>
+  <a href="https://github.com/dexoron/dcr/stargazers"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/dexoron/dcr?style=flat"></a>
+  <a href="LICENSE"><img alt="License: GPL-3.0" src="https://img.shields.io/badge/License-GPL--3.0-blue.svg"></a>
+</p>
 
-[![CI](https://github.com/dexoron/dcr/actions/workflows/ci.yml/badge.svg)](https://github.com/dexoron/dcr/actions/workflows/ci.yml)
-[![GitHub Release](https://img.shields.io/github/v/release/dexoron/dcr)](https://github.com/dexoron/dcr/releases/latest)
-[![Platform](https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-lightgrey)](https://github.com/dexoron/dcr/releases)
-<br/>
-[![AUR](https://img.shields.io/aur/version/dcr)](https://aur.archlinux.org/packages/dcr)
-[![Crates.io](https://img.shields.io/crates/v/dcr)](https://crates.io/crates/dcr)
-[![Homebrew](https://img.shields.io/badge/homebrew-dexoron%2Fdexoron-orange)](https://github.com/dexoron/homebrew-dexoron)
-<br/>
-[![GitHub Stars](https://img.shields.io/github/stars/dexoron/dcr?style=flat)](https://github.com/dexoron/dcr/stargazers)
-[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](LICENSE)
-
-</div>
+<!-- Snap badge removed: classic confinement was denied for this project. -->
 
 ---
 
 ## Why DCR?
 
 - **No boilerplate** — one config file, predictable structure
-- **Cargo-like workflow** — `build`, `run`, `clean`, `test`, `add`
+- **Cargo-like workflow** — `build`, `run`, `clean`, `test`, `add`, `fmt`
 - **Cross-compilation** — full target triple support with short names
 - **IDE integration** — VS Code, CLion, `compile_commands.json` out of the box
 - **Dependencies** — path, git, and registry-based with lock file
+- **Man pages** — `man dcr` and per-command pages (`man dcr-build`, `man dcr-new`, etc.)
 
 ---
 
@@ -77,6 +78,18 @@ brew tap dexoron/dexoron
 brew install dcr
 ```
 
+</td>
+</tr>
+<tr>
+<td><b>Nix (flake)</b></td>
+<td>
+
+```sh
+nix run github:dexoron/dcr
+# or install to profile:
+nix profile install github:dexoron/dcr
+```
+
 </td>
 </tr>
 <tr>
@@ -94,7 +107,7 @@ cargo install dcr
 <td>
 
 ```sh
-curl -fsSL https://dcr.dexoron.su/install.sh | bash
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
 ```
 
 </td>
@@ -104,7 +117,20 @@ curl -fsSL https://dcr.dexoron.su/install.sh | bash
 <td>
 
 ```sh
-curl -fsSL https://dcr.dexoron.su/install_bsd.sh | bash
+curl -fsSL https://dcr.dexoron.su/install_bsd.sh | sh
+```
+
+</td>
+</tr>
+<tr>
+<td><b>Snap (Linux)</b></td>
+<td>
+
+> Snap Store publishing temporarily disabled — see [#51671](https://forum.snapcraft.io/t/classic-confinement-request-for-dcrup/51671).
+> Download the `.snap` from [GitHub Releases](https://github.com/dexoron/dcr/releases/latest) and install manually:
+
+```sh
+sudo snap install --classic --dangerous dcrup_*.snap
 ```
 
 </td>
@@ -188,24 +214,26 @@ kind = "bin"
 | `dcr gen <vscode\|clion\|compile-commands>` | Generate IDE integration |
 | `dcr setup` | Initialize DCR registry |
 
-other in [docs/](docs/) and `dcr --help`
+other in [docs/](docs/), `dcr --help` and `dcr <command> --help`
 
 ---
 
-## Platforms(pre-build source)
+## Platforms (pre-built binary)
 
 <div align="center">
 
-| OS | x86_64 | aarch64 | armv7 | i686 | riscv64 | GNU | Musl | MSVC | MinGW |
-|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
-| Linux   | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ |
-| macOS   | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| Windows | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ |
-| FreeBSD | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| OpenBSD | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| NetBSD  | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
+| OS | x86_64 | aarch64 | armv7 | i686 | riscv64 |
+|:---:|:---:|:---:|:---:|:---:|:---:|
+| Linux (GNU)     | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Linux (Musl)    | ✅ | ✅ | ✅ | ✅ | 🚧 |
+| macOS           | ✅ | ✅ | ❌ | ❌ | ❌ |
+| Windows (MSVC)  | ✅ | ✅ | ❌ | ✅ | ❌ |
+| Windows (MinGW) | ✅ | 🚧 | ❌ | ❌ | ❌ |
+| FreeBSD         | ✅ | 🚧 | ❌ | ❌ | ❌ |
+| OpenBSD         | ✅ | 🚧 | ❌ | ❌ | ❌ |
+| NetBSD          | ✅ | 🚧 | ❌ | ❌ | ❌ |
 
-✅ officially supported · ⚠️ community / best-effort · ❌ not supported
+✅ pre-built binary · 🚧 planned · ❌ not supported by platform or CI
 
 </div>
 
@@ -245,6 +273,7 @@ cargo test
 <div align="center">
 
 GPL-3.0 — see [LICENSE](LICENSE)<br/>
+DCR is a build tool, not a library. The GPL applies only to DCR's own source code, not to projects built with it.<br/>
 Made with ❤️ by [Dexoron](https://github.com/dexoron) and contributors.
 
-</div>
+</div>

build.rs

@@ -18,4 +18,37 @@
 fn main() {
     let target = std::env::var("TARGET").unwrap_or_else(|_| "unknown-target".to_string());
     println!("cargo:rustc-env=DCR_TARGET={target}");
+
+    // Let's try to retrieve the commit hash for the version
+    let commit = std::process::Command::new("git")
+        .args(["rev-parse", "--short", "HEAD"])
+        .output()
+        .ok()
+        .and_then(|o| {
+            if o.status.success() {
+                String::from_utf8(o.stdout)
+                    .ok()
+                    .map(|s| s.trim().to_string())
+            } else {
+                None
+            }
+        });
+
+    // Check if there are any uncommitted changes in the repository
+    let is_dirty = std::process::Command::new("git")
+        .args(["status", "--porcelain"])
+        .output()
+        .ok()
+        .map(|o| o.status.success() && !o.stdout.is_empty())
+        .unwrap_or(false);
+
+    if let Some(commit_hash) = commit {
+        let dirty_suffix = if is_dirty { "-dirty" } else { "" };
+        println!(
+            "cargo:rustc-env=DCR_GIT_INFO= (git {}{})",
+            commit_hash, dirty_suffix
+        );
+    } else {
+        println!("cargo:rustc-env=DCR_GIT_INFO=");
+    }
 }

docs/README.md

@@ -1,46 +0,0 @@
-# Introduction
-
-DCR (Dexoron Cargo Realization) is a Cargo-style CLI for C/C++ projects.
-
-Current DCR focuses on a simple, predictable workflow:
-
-- create or initialize a project (`dcr new`, `dcr init`)
-- build with `debug` or `release` profiles (`dcr build`)
-- run binaries (`dcr run`)
-- clean artifacts (`dcr clean`)
-- update the installed binary (`dcr --update`)
-
-## What is implemented in this version
-
-- Project configuration in `dcr.toml` with `[package]`, `[build]`, `[dependencies]`.
-- Recursive source discovery in `src/`:
-  - C: `*.c`
-  - C++: `*.cpp`, `*.cxx`, `*.cc`
-- Compiler selection from `dcr.toml` (`clang`, `gcc`, `cl`, `clang-cl`, etc.).
-- ASM support via `language = "asm"` (GCC/Clang, NASM, GAS).
-- Mixed language builds via `language = ["c", "asm"]` and similar combinations.
-- Three build kinds:
-  - `bin` (default)
-  - `staticlib`
-  - `sharedlib`
-- Optional custom output directory via `build.target`.
-- Optional `build.platform` to pass architecture hints (`-march` / `/arch`).
-- Optional `build.exclude`/`build.include` for source/header selection.
-- Optional `build.roots`/`build.src_disable` to replace the default `src/` root.
-- Optional build steps with `build.steps` and `build.post_steps`.
-- Optional `build.pkg_config` integration.
-- Optional `build.clean` and `build.expect`.
-- Optional `[run].cmd` to override run command.
-- Workspace builds via `[workspace]` with per-project `dcr.toml`.
-- Path dependencies with include/lib resolution and `dcr.lock` generation.
-
-## Important behavior notes
-
-- `dcr.toml` is required for `build`, `run`, and `clean`.
-- `run` works only with `build.kind = "bin"`.
-- Incremental rebuild tracks source file timestamps and header dependencies (rebuilds when either source or included headers change).
-- Object files are always created under `target/<profile>/obj/`.
-
-## Repository
-
-- <https://github.com/dexoron/dcr>

docs/README.mdx

@@ -0,0 +1,63 @@
+---
+sidebar_label: Introduction
+---
+
+# DCR — C/C++ Build Tool & Package Manager
+
+<details>
+<summary>Quick reference</summary>
+
+```bash
+# Installation
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+
+# Create a project
+dcr new my-app
+cd my-app
+
+# Build and run
+dcr build
+dcr run
+
+# Run tests
+dcr test
+
+# Add a dependency
+dcr add fmt
+
+# Generate IDE files
+dcr gen vscode
+```
+
+</details>
+
+## Contents
+
+| Section | Description |
+|---------|-------------|
+| [Getting Started](/docs/getting-started/installation) | Installation and first steps |
+| [Commands](/docs/commands/project-commands) | All CLI commands |
+| [Reference](/docs/reference/dcr-toml) | Configuration, build, dependencies, platforms |
+| [Testing](/docs/testing/test-framework) | Built-in test framework |
+| [Recipes](/docs/recipes/cross-to-windows) | Common scenarios |
+| [IDE Integration](/docs/ide-integration) | VS Code, CLion, compile_commands.json |
+| [Self Update](/docs/self-update) | Auto-update |
+| [FAQ](/docs/faq) | Frequently asked questions |
+| [Changelog](/docs/changelog) | Version history |
+| [License](/docs/license) | DCR and vendored library licenses |
+| [Contributing](/docs/contributing) | DCR development |
+
+## Features
+
+- **Incremental builds** — mtime + `.d` headers + SHA256 fingerprint
+- **Parallel compilation** — thread::scope, atomic task queue
+- **4 backends** — gcc/clang, MSVC/clang-cl, GAS (ARM), NASM (x86)
+- **7 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom
+- **Cross-compilation** — short names and full triples
+- **Profiles** — debug / release with field overrides
+- **Workspaces** — multi-package projects with topological sort
+- **Registry + Git + Path** — three dependency mechanisms
+- **IDE generation** — VS Code, CLion, compile_commands.json, JSON metadata
+- **pkg-config** — automatic system library discovery
+- **Per-command `--help`** — `dcr build --help`, `dcr new --help`, etc.
+- **Man pages** — `man dcr`, `man dcr-build`, `man dcr-new`

docs/SUMMARY.md

@@ -1,50 +0,0 @@
-# Table of contents
-
-* [Introduction](README.md)
-
-## Getting started
-
-* [Installation](getting-started/installation.md)
-* [Create your first project](getting-started/create-your-first-project.md)
-* [Project structure](getting-started/project-structure.md)
-* [Build and run](getting-started/build-and-run.md)
-
-## Configuration
-
-* [dcr.toml overview](configuration/dcr.toml-overview.md)
-* [Package section](configuration/package-section.md)
-* [Build section](configuration/build-section.md)
-* [Dependencies section](configuration/dependencies-section.md)
-* [Build profiles](configuration/build-profiles.md)
-
-## Commands
-
-* [Global options](commands/global-options.md)
-* [dcr init/new](commands/dcr-init-or-new.md)
-* [dcr add](commands/dcr-add.md)
-* [dcr build](commands/dcr-build.md)
-* [dcr run](commands/dcr-run.md)
-* [dcr clean](commands/dcr-clean.md)
-* [dcr gen](commands/dcr-gen.md)
-* [dcr test](commands/dcr-test.md)
-* [dcr fmt](commands/dcr-fmt.md)
-* [dcr tree](commands/dcr-tree.md)
-
-## Dependencies & Build
-
-* [Dependency format](dependencies-and-build/dependency-format.md)
-* [Local dependencies](dependencies-and-build/local-dependencies.md)
-* [Versioning & lock file](dependencies-and-build/versioning-and-lock-file.md)
-* [Target directory](dependencies-and-build/target-directory.md)
-* [Cross-compilation and targets](dependencies-and-build/cross-compilation.md)
-* [Compilers & linking](dependencies-and-build/compilers-and-linking.md)
-
-## Reference & Help
-
-* [CLI reference](reference-and-help/cli-reference.md)
-* [Config reference](reference-and-help/config-reference.md)
-* [Workspace guide](reference-and-help/workspace-guide.md)
-* [Flags & environment](reference-and-help/flags-and-environment.md)
-* [Troubleshooting map](reference-and-help/troubleshooting-map.md)
-* [FAQ](reference-and-help/faq.md)
-* [Contributing & Bug reports](reference-and-help/contributing-and-bug-reports.md)

docs/changelog.mdx

@@ -0,0 +1,91 @@
+---
+sidebar_label: Changelog
+---
+
+# Changelog
+
+## 0.7.1 (2026-06-02)
+
+### Added
+
+- **`--help` for all commands** — `dcr build --help`, `dcr run --help`, `dcr new --help`,
+  `dcr init --help`, `dcr clean --help`, `dcr add --help`, `dcr fmt --help`,
+  `dcr setup --help`, `dcr tree --help`, `dcr gen --help`, `dcr --update --help`,
+  `dcr test --help`. All output uses styled headers (green) and usage lines (cyan).
+- **Man pages** — 12 troff pages in `man/man1/`: `dcr.1`, `dcr-build.1`,
+  `dcr-run.1`, `dcr-new.1`, `dcr-init.1`, `dcr-clean.1`, `dcr-add.1`, `dcr-test.1`,
+  `dcr-gen.1`, `dcr-fmt.1`, `dcr-tree.1`, `dcr-setup.1`.
+- **Man pages in all packaging** — install.sh, install_bsd.sh, AUR PKGBUILD,
+  Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew
+  (resource), Snap, GitHub Release assets.
+- **Project name validation** — `dcr init` and `dcr new` now validate names before
+  creating files. Only ASCII letters, digits, `_` and `-` are allowed.
+- **`documentation` and `homepage` fields** — added to `Cargo.toml`.
+- **Release profile optimizations** — `opt-level = "z"`, LTO, `codegen-units = 1`,
+  `panic = "abort"`, `strip = true` for smaller binaries.
+- **Linux i686, armv7, riscv64 targets** — added to release workflow and install scripts.
+- **Linux musl i686, armv7 targets** — cross-compiled via zigbuild in CI.
+- **AUR packages** — `dcr-dev`, `dcr-dev-bin` publishing workflow.
+- **Snap publishing** — automated Snapcraft publishing in CI.
+- **Snap badge** — in README.
+
+### Changed
+
+- **`validate_package_name` made public** — callable from CLI commands.
+- **README platform table** — reorganized: libc variants as separate OS rows,
+  removed extra columns. Linux architecture list updated.
+- **`gen.rs` no-args output** — now uses styled output instead of raw `eprintln!`.
+- **`tree.rs`, `fmt.rs`, and `setup.rs`** — now accept arguments for `--help`.
+- **README install commands** — `| bash` → `| sh` for POSIX compatibility.
+
+### Fixed
+
+- **`dcr new <invalid-name>` creates directory then fails** — validation now
+  happens before any file operations.
+- **`dcr init` on invalid directory name** — same fix.
+- **Man pages missing in installed packages** — now shipped in all formats.
+- **Windows drive letter false positive** — in dependency file parser.
+- **CRLF (`\r\n`) breaks dependency parser** — now handles mixed line endings.
+- **Newline after backslash not consumed** — in `parse_d_file` escape handling.
+
+## 0.7.0 (2026-06-01)
+
+### Added
+
+- **OpenBSD and NetBSD target support** — full platform routing with dynamic target triples using `std::env::consts::ARCH` and `std::env::consts::OS`. Affects `build`, `run`, `clean` commands and the platform module.
+- **`src/platform/bsd.rs`** — new BSD platform module (shared by FreeBSD, OpenBSD, NetBSD) providing `bin_path`, `lib_path`, `elf_path`, `efi_path`, `shared_lib_path`.
+- **`build.out_dir` config option** — custom output directory that overrides the default `target/<triple>/<profile>` path for final artifacts. Supported in `build`, `run`, and config validation.
+- **`dcr fmt` command** — new CLI command that formats all C/C++ source files (`*.c`, `*.cpp`, `*.h`, `*.hpp`) in `src/` and `tests/` using `clang-format`.
+- **Incremental linking** — `needs_link()` in `common.rs` checks if any object file is newer than the linked output, skipping unnecessary relinking. Implemented for all backends (`unix_cc`, `msvc`, `gas`, `nasm`).
+- **`build.kind = "none"` and `"custom"`** — two new project kinds for special build scenarios that don't produce standard artifacts.
+- **`install_bsd.sh`** — POSIX-compliant installation script for BSD systems (FreeBSD, OpenBSD, NetBSD) with binary download and source build modes.
+- **Linux ARM64 support in `install.sh`** — added `Linux:aarch64|Linux:arm64` target detection for pre-built binary downloads.
+- **BSD OS detection in `install.sh`** — detects FreeBSD, OpenBSD, NetBSD and determines target triple.
+- **`rust-toolchain.toml`** — explicit toolchain pinning to `stable` channel.
+- **Integration tests** — `build_with_target_config` (verifies `build.target = "linux"`) and `build_with_out_dir` (validates custom output directory).
+- **`get_build_string_with_profile` made `pub`** — so `run.rs` can determine custom output directory configuration.
+
+### Changed
+
+- **`build.target` semantics changed** — now strictly contains a target triple (e.g., `x86_64-unknown-linux-gnu`) or short name (`linux`, `macos`, `windows`). No longer used as custom output directory — this functionality moved to `build.out_dir`.
+- **`build.standard` made optional** — changed from `String` to `Option<String>`. Validation only enforces non-empty for non-ASM languages. Skipped in `dcr.toml` output if empty.
+- **`dcr run` with `out_dir`** — now determines target directory respecting `build.out_dir` via `get_build_string_with_profile()` from `build.rs`.
+- **`collect_sources()` returns empty vector** instead of error when no sources are found, allowing `kind = "none"` or `kind = "custom"` projects with no source files.
+- **CI/CD release workflow refactored** — `git2` made target-specific (no vendored-openssl on Windows), Zig-based cross-compilation for non-x86_64 Linux targets, Arch Linux package version cleanup (dashes → dots), `gmake` symlink for NetBSD.
+- **README compatibility table** — FreeBSD, OpenBSD, NetBSD build/run status upgraded from "community/best-effort" to "officially supported".
+- **Documentation updated** — `build-section.md` describes new `build.target` and `build.out_dir` fields. `target-directory.md` rewritten to clarify the distinction.
+
+### Fixed
+
+- **stdout/stderr not inherited in `dcr run`** — child process output was captured and manually printed, breaking interactive programs. Fixed by switching to `Command::status()`.
+- **Race condition in release CI** — matrix build jobs could upload assets to a release that didn't exist yet. Fixed by adding a dedicated `create-release` job.
+- **Release GHA — stable toolchain override** — fixed Rust toolchain override issues in CI.
+- **Arch Linux package version sanitization** — version strings with dashes (e.g., `0.7.0-dev`) are invalid for `pkgver`. Fixed by replacing dashes with dots.
+- **GPG permissions after Docker** — Docker operations changed GPG directory ownership. Fixed by running `chown` after Docker commands.
+- **RPM artifact paths** — RPM artifacts were placed in `rpm/x86_64/` instead of `fedora/x86_64/`. Fixed in Dexoron Packages Index workflow.
+- **JSON parsing reliability in `install.sh`** — added `jq` as primary parser with `python3` fallback for dev channel release lookup.
+
+### Removed
+
+- **`format_roots()` helper function** — removed from `common.rs`. Was only used by the old error handling path in `collect_sources()`.
+- **Per-distribution artifact download steps** — three separate `actions/download-artifact` steps replaced with unified `gh release download --clobber`.

docs/commands/build-commands.mdx

@@ -0,0 +1,42 @@
+---
+sidebar_label: Build commands (build, run, clean)
+---
+
+# Build Commands
+
+## `dcr build`
+
+Builds the project according to `dcr.toml`.
+
+```bash
+dcr build                         # debug profile
+dcr build --release               # release build
+dcr build --debug                 # explicit debug
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --force                 # full rebuild
+dcr build --clean                 # clean + build
+dcr build --verbose               # show compilation commands
+dcr build --workspace pkg-a       # build specific workspace package
+```
+
+Artifacts: `target/<triple>/<profile>/<binary-name>` (Linux with explicit target).
+
+## `dcr run`
+
+Builds (if sources are newer than artifacts) and runs the binary.
+
+```bash
+dcr run
+dcr run --release
+```
+
+## `dcr clean`
+
+Removes `target/` directory (or `target/<target>/<profile>`).
+
+```bash
+dcr clean
+dcr clean --release               # target/release/ only
+dcr clean --target windows        # target/x86_64-pc-windows-msvc/
+dcr clean --all                   # clean all workspace packages
+```

docs/commands/dcr-add.md

@@ -1,37 +0,0 @@
-# dcr add
-
-Add a dependency to `dcr.toml`.
-
-## Usage
-
-```bash
-dcr add <name> [source] [options]
-```
-
-If `<source>` is omitted and a registry is configured, DCR will look up the
-package by name in the registry and add it as a version dependency.
-
-## Sources
-
-- *omitted*: Look up in the configured registry.
-- `path:./path/to/lib`: Local directory.
-- `github:user/repo`: GitHub repository.
-- `gitlab:user/repo`: GitLab repository.
-- `git:host.com/user/repo`: Generic Git repository (HTTPS).
-- `https://...`: Full Git URL.
-
-## Options
-
-- `--branch <name>`: Use a specific branch.
-- `--tag <name>`: Use a specific tag.
-- `--rev <sha>`: Use a specific commit hash.
-
-## Examples
-
-```bash
-dcr add my_lib path:./libs/my_lib
-dcr add cool_lib github:user/cool_lib
-dcr add shared_lib gitlab:org/shared --branch develop
-dcr add custom_lib git:git.internal.com/r/lib --tag v1.0.0
-dcr add mylib                    # Looks up in registry
-```

docs/commands/dcr-build.md

@@ -1,80 +0,0 @@
-# dcr build
-
-Builds the project in `debug` or `release` profile.
-
-## Usage
-
-```sh
-dcr build
-dcr build --debug
-dcr build --release
-dcr build --target linux --release
-dcr build --release --force
-dcr build --debug --clean
-```
-
-## What `build` does
-
-1. Checks that `dcr.toml` exists and is valid.
-2. Reads build settings from `[build]`.
-3. Resolves path dependencies from `[dependencies]`.
-4. Creates required output directories.
-5. Recursively compiles sources from `src/`.
-6. Links final artifact (binary or library).
-
-## Config values used
-
-- `package.name`
-- `build.filename`
-- `build.extension`
-- `build.compiler`
-- `build.language`
-- `build.standard`
-- `build.cxx_standard`
-- `build.kind`
-- `build.target`
-- `build.out_dir`
-- `build.platform`
-- `package.type`
-- `build.cflags`
-- `build.ldflags`
-- `build.ldscript`
-- `build.debug` / `build.release`
-- `build.exclude`
-- `build.include`
-- `build.pkg_config`
-- `build.steps`
-- `build.post_steps`
-- `build.generated`
-- `build.expect`
-- `build.clean`
-
-## Source selection
-
-- `language = "c"` -> `*.c`
-- `language = "c++" | "cpp" | "cxx"` -> `*.cpp`, `*.cxx`, `*.cc`
-- `language = "asm"` -> `*.s`, `*.S`, `*.asm`
-- Mixed languages are supported with arrays, for example `language = ["c", "asm"]`.
-- By default sources are searched in `src/`; use `build.roots` and `build.src_disable` to override.
-
-## Notes
-
-- Profile flag (`--debug` / `--release`) can appear in any argument position (duplicates are rejected).
-- Unknown profile flags return an error.
-- `--target <triple>` builds for specified target (short names: `linux`, `macos`, `windows`, `freebsd`, `openbsd`, `netbsd`).
-- `--verbose` prints the compiler/linker command lines to stderr (also works via `DCR_DEBUG` env var).
-- `--workspace <name>` filters build to a specific workspace member.
-- If no `--target`, builds for `build.targets` or native.
-- Incremental rebuild checks source/object mtime and tracked header dependencies.
-- `--force` skips build cache checks and recompiles.
-- `--clean` removes `target/<profile>` and `build.clean` paths before building.
-- `build.filename` + `build.extension` allow full control over the final artifact name (e.g. `KERNEL.BIN` instead of using `package.name`). When `build.kind = "efi"`, the output is a PE32+ executable with `.efi` extension.
-- `build.kind = "efi"` links with `-shared -nostdlib -Wl,-dll -Wl,--subsystem,10` for UEFI PE32+ format. Use `build.filename` and `build.extension` for full control over the artifact name.
-- `build.kind = "elf"` produces a bare-metal ELF executable. Linking flags are user-controlled via `build.ldflags` (no PIE/CRT defaults are added).
-- Default GCC/Clang profile flags: `debug` -> `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG`, `release` -> `-O3 -DNDEBUG`.
-  These defaults are **not applied** for bare-metal targets (e.g. `aarch64-none-elf`, targets containing `none` / `-elf` / `eabi`).
-- For `language = "asm"` with `compiler = "as"`/`"gas"`, use `.s` files (no preprocessing). For `.S`, use `gcc` or `clang`.
-- In workspace root, `dcr build` builds all members in dependency order.
-- `build.exclude` removes paths from source/header collection; `build.include` re-allows matching paths and has priority over `exclude`.
-- `build.steps` run before compilation; `build.post_steps` run after linking.
-- `build.generated` is cleaned when `build.steps` need to rerun; `build.expect` is verified after post-steps.

docs/commands/dcr-clean.md

@@ -1,27 +0,0 @@
-# dcr clean
-
-Removes build artifacts in `target/`.
-
-## Usage
-
-```sh
-dcr clean
-dcr clean --debug
-dcr clean --release
-dcr clean --all
-dcr clean --release --all
-```
-
-## Behavior
-
-- Without arguments: removes entire `target/`.
-- With profile: removes only the profile-specific directory. Respects `build.target` from config: if `build.target = "aarch64-unknown-linux-gnu"`, cleans `target/aarch64-unknown-linux-gnu/<profile>/`.
-- With `--all`: also cleans all workspace members.
-- Additionally removes paths from `build.clean` if configured.
-- `build.clean` supports `{profile}` and version placeholders.
-
-## Validation
-
-- `dcr.toml` must exist.
-- Unknown flags are treated as error.
-- If `target` or selected profile directory does not exist, command prints a warning.

docs/commands/dcr-fmt.md

@@ -1,19 +0,0 @@
-# dcr fmt
-
-Formats all C/C++ source files using `clang-format`.
-
-## Usage
-
-```sh
-dcr fmt
-```
-
-## Behavior
-
-1. Scans `src/` and `tests/` directories recursively.
-2. Formats all C/C++ source and header files (`.c`, `.cpp`, `.cxx`, `.cc`, `.h`, `.hpp`, `.hxx`, `.hh`) using `clang-format`.
-3. Uses `.clang-format` if present in the project root, otherwise falls back to LLVM style.
-
-## Requirements
-
-- `clang-format` must be installed and available in PATH.

docs/commands/dcr-gen.md

@@ -1,170 +0,0 @@
-# dcr gen
-
-Generates IDE and build tool integration files for C/C++ development environments.
-
-## Usage
-
-```sh
-dcr gen project-info
-dcr gen project-info --release
-dcr gen compile-commands
-dcr gen compile-commands --debug
-dcr gen vscode
-dcr gen vscode --release
-dcr gen clion
-dcr gen clion --debug
-```
-
-## Subcommands
-
-### `dcr gen project-info`
-
-Outputs project metadata as JSON array.
-
-```sh
-dcr gen project-info [--debug | --release]
-```
-
-Outputs structured information about the project (root project + all workspace members if present):
-
-```json
-[
-  {
-    "name": "my-project",
-    "version": "1.0.0",
-    "root": "/path/to/root",
-    "profile": "debug",
-    "language": "c++",
-    "standard": "c++17",
-    "compiler": "g++",
-    "kind": "bin",
-    "sources": ["/path/to/root/src/main.cpp", ...],
-    "include_dirs": ["/path/to/dep/include", ...],
-    "lib_dirs": ["/path/to/dep/lib", ...],
-    "libs": ["somelib", ...],
-    "cflags": ["-Wall", ...],
-    "ldflags": ["-lm", ...]
-  }
-]
-```
-
-This is useful for integrating DCR projects with custom build tools or scripts.
-
-### `dcr gen compile-commands`
-
-Generates `compile_commands.json` for use by `clangd`, `clang-tidy`, and other tools.
-
-```sh
-dcr gen compile-commands [--debug | --release]
-```
-
-Writes `./compile_commands.json` containing compilation database entries for all source files. This file is recognized by:
-- LSP servers (`clangd`, `clang-tools-extra`)
-- Linters (`clang-tidy`)
-- Format tools (`clang-format`)
-
-The entries include:
-- Full compiler command with flags
-- Source file path
-- Object file output path
-- Project root as working directory
-
-### `dcr gen vscode`
-
-Generates Visual Studio Code integration files.
-
-```sh
-dcr gen vscode [--debug | --release]
-```
-
-Creates `.vscode/` directory with:
-
-- **`launch.json`**: Debug configurations (one per binary target, debug + release variants)
-- **`tasks.json`**: Build/run/clean tasks using `dcr` commands
-- **`settings.json`**: Clangd configuration pointing to `compile_commands.json`
-- **`extensions.json`**: Recommends `clangd`, disables `cpptools`
-- **`compile_commands.json`**: Compilation database (same as `dcr gen compile-commands`)
-
-Usage in VSCode:
-- Open the Command Palette (`Ctrl+Shift+P`) and select **"Debug: Start Debugging"** to run debugger
-- Press `Ctrl+Shift+B` to run the build task
-- Clangd will provide IntelliSense and diagnostics based on `compile_commands.json`
-- Generated `launch.json` uses CodeLLDB (`type: "lldb"`), so install `vadimcn.vscode-lldb`
-
-### `dcr gen clion`
-
-Generates JetBrains CLion integration files.
-
-```sh
-dcr gen clion [--debug | --release]
-```
-
-Creates `.idea/` directory with:
-
-- **`externalTools.xml`**: Registers DCR build/clean/gen commands as external tools
-- **`customTargets.xml`**: Defines build targets for debug and release
-- **`misc.xml`**: Points CLion to `compile_commands.json` for compilation database
-- **`.idea/.gitignore`**: Ignores auto-generated files
-- **`runConfigurations/*.xml`**: Debug run configs (one per binary target)
-- **`compile_commands.json`**: Compilation database (same as `dcr gen compile-commands`)
-
-Usage in CLion:
-- Build/clean via **Tools → DCR → Build Debug/Release/Clean**
-- Run/debug via **Run → Run Configurations** (dropdown) → select generated config
-- Code completion and diagnostics come from the compilation database
-
-## Config values used
-
-- `package.name`
-- `build.compiler`
-- `build.language`
-- `build.standard`
-- `build.kind`
-- `build.target`
-- `build.platform`
-- `build.cflags`
-- `build.ldflags`
-- `build.debug` / `build.release`
-- `build.exclude`
-- `build.include`
-- `build.pkg_config`
-- `build.roots`
-- `build.src_disable`
-- Workspace members (if `[workspace]` is present)
-
-## Workspace support
-
-When running `dcr gen` in a workspace root, all commands process both the root project and all workspace members:
-
-- `project-info` returns an array with entries for each member + root
-- `compile-commands` includes entries from all members
-- `vscode` and `clion` generate unified configurations that work across all members
-
-## Troubleshooting
-
-### Clangd not picking up includes
-
-- Ensure `compile_commands.json` exists in the workspace root
-- In VSCode settings, verify `clangd.arguments` includes `--compile-commands-dir=<workspace-root>`
-- Rebuild via `dcr gen compile-commands` if sources or dependencies changed
-
-### Debug configuration not working
-
-- Verify binary paths in `launch.json` match actual build output (`target/<profile>/binary-name`)
-- For workspace projects, each member's debug config uses its own `target/` directory
-- Ensure GDB/LLDB is installed: `gdb --version` or `lldb --version`
-- If VSCode reports unsupported debugger type, install the extension that matches `launch.json` type (`vadimcn.vscode-lldb` for `lldb`)
-
-### CLion not recognizing includes
-
-- Regenerate via `dcr gen clion --debug`
-- File → Invalidate Caches → Invalidate and Restart
-- Verify `.idea/misc.xml` points to correct `compile_commands.json` path
-
-## Notes
-
-- Profiles default to `debug` if not specified
-- Generation does not require the project to be built first
-- Generated files are safe to commit; they are generated from `dcr.toml` and thus repeatable
-- IDE configurations may be customized after generation, but changes will be overwritten on next `dcr gen` run
-- For multi-binary projects, `vscode` and `clion` generate debug configs for all binaries (both debug + release variants)

docs/commands/dcr-init-or-new.md

@@ -1,43 +0,0 @@
-# dcr init/new
-
-## `dcr new <name>`
-
-Creates a new project directory and initializes it.
-
-```sh
-dcr new hello
-```
-
-Behavior:
-
-1. Validates arguments (`<name>` is required, only one name is allowed).
-2. Creates `<name>/`.
-3. Creates `<name>/dcr.toml`.
-4. Sets `package.name = "<name>"`.
-5. Creates `<name>/src/main.c` with a Hello World template.
-
-Errors:
-
-- Missing project name.
-- Extra arguments.
-- Target directory already exists.
-
-## `dcr init`
-
-Initializes DCR in the current directory.
-
-```sh
-dcr init
-```
-
-Behavior:
-
-1. Requires current directory to be empty.
-2. Creates `dcr.toml`.
-3. Sets `package.name` from the current directory name.
-4. Creates `src/main.c`.
-
-Errors:
-
-- Any arguments are treated as invalid.
-- Non-empty directory is rejected.

docs/commands/dcr-run.md

@@ -1,41 +0,0 @@
-# dcr run
-
-Builds the project and runs the resulting binary.
-
-## Usage
-
-```sh
-dcr run
-dcr run --debug
-dcr run --release
-dcr run --target linux --release
-dcr run --release --force
-dcr run --debug --clean
-```
-
-## Behavior
-
-1. Validates `dcr.toml`.
-2. Reads `package.name`, `build.kind`, and optional `build.target`.
-3. Runs the same build flow as `dcr build`.
-4. Executes the built artifact path for the selected profile.
-5. If `[run].cmd` is set, runs that command instead of the built binary.
-
-## Restrictions
-
-- If `build.kind` (or `build.{profile}.kind`) is `"staticlib"`, `"sharedlib"`, `"efi"`, or `"elf"`, `run` exits with error.
-- The profile is selected from the first argument.
-- `--target <triple>` runs the binary for specified target (short names: `linux`, `macos`, `windows`, `freebsd`, `openbsd`, `netbsd`).
-- `--force` skips build cache checks and recompiles.
-- `--clean` removes `target/<profile>` and `build.clean` paths before building.
-- `--workspace <name>` filters build to a specific workspace member.
-
-## `run.cmd` variables
-
-`run.cmd` supports the same variables as build steps: `{profile}`, `{version}`, `{version_major}`,
-`{version_minor}`, `{version_patch}`, `{version_suffix}`, `{version_suffix_dash}`.
-The command runs via `sh -c` on Unix and `cmd /C` on Windows.
-
-## On build failure
-
-`dcr run` attempts to launch an existing binary from the same profile if present; otherwise it reports that code errors must be fixed.

docs/commands/dcr-test.md

@@ -1,45 +0,0 @@
-# dcr test
-
-Runs the project's test suite.
-
-## Usage
-
-```sh
-dcr test
-dcr test --debug
-dcr test --release
-dcr test --target linux
-dcr test --init
-```
-
-## What `test` does
-
-1. Builds the project with the specified profile/target.
-2. Compiles test files in `tests/` (e.g., `tests/test.c`) into a test binary.
-3. Runs the test binary and parses output for PASS/SKIP/FAIL results.
-4. Reports summary with colored output.
-
-## Test Structure
-
-DCR uses a simple test framework:
-
-- Header: `tests/dcr_test.h` (generated by `dcr test --init`)
-- Test file: `tests/test.c` (template generated by `dcr test --init`)
-- Macros: `TEST(name)`, `TEST_CASE(name)`, `EXPECT(condition)`, `SKIP(reason)`
-- Output: `[PASS] test_name`, `[FAIL] test_name`, or `[SKIP] test_name`
-
-## Config values used
-
-- `package.name`
-- `build.compiler`, `build.language`, `build.standard`
-- `build.cflags`, `build.ldflags`
-- `build.debug` / `build.release`
-- `build.targets` (if specified)
-
-## Notes
-
-- Test binary is linked with the main project (for lib projects) or standalone.
-- `--init` creates `tests/dcr_test.h` and `tests/test.c` if missing.
-- Tests run in debug mode by default. Use `--release` for release mode.
-- Custom test logic can be added by editing `tests/test.c`.
-- Fails if no `tests/test.c` exists (run `dcr test --init` first).

docs/commands/dcr-tree.md

@@ -1,22 +0,0 @@
-# dcr tree
-
-Displays a visual dependency tree for the current project (similar to `cargo tree`).
-
-## Usage
-
-```sh
-dcr tree
-dcr tree --invert
-dcr tree -p some-package
-```
-
-## What it shows
-
-- All direct and transitive dependencies
-- Version of each dependency
-- Whether a dependency is a registry, git, or path dependency
-
-## Notes
-
-- Useful for debugging dependency issues and understanding the build graph.
-- Output format is inspired by `cargo tree`.

docs/commands/dependency-commands.mdx

@@ -0,0 +1,51 @@
+---
+sidebar_label: Dependency commands (add, tree)
+---
+
+# Dependency Commands
+
+## `dcr add <name> [source]`
+
+Adds a dependency to `dcr.toml`.
+
+```bash
+dcr add fmt                    # registry lookup
+dcr add mylib ../path/to/lib   # path as source
+dcr add mylib path:./lib       # explicit path prefix
+dcr add mylib git:https://github.com/user/repo  # explicit git prefix
+dcr add mylib github:user/repo # GitHub shorthand
+dcr add mylib gitlab:user/repo # GitLab shorthand
+```
+
+Source prefixes:
+- `path:` — local path
+- `git:` — generic git URL
+- `github:` — expands to `https://github.com/<user>/<repo>`
+- `gitlab:` — expands to `https://gitlab.com/<user>/<repo>`
+- `http://` / `https://` / `git@` — full URL
+
+Flags:
+- `--branch <name>` — git branch
+- `--tag <name>` — git tag
+- `--rev <hash>` — git commit
+
+If source is omitted — DCR searches connected registries.
+
+## `dcr tree`
+
+Displays the project dependency tree.
+
+```bash
+dcr tree
+```
+
+Example output:
+
+```
+my-app v0.1.0
+├── fmt (registry)
+│   └── spdlog (registry)
+└── catch2 (registry)
+```
+
+For path dependencies, recursively shows their own dependencies (from their `dcr.toml`).

docs/commands/gen-commands.mdx

@@ -0,0 +1,71 @@
+---
+sidebar_label: Gen commands (vscode, clion, ...)
+---
+
+# Gen Commands
+
+## `dcr gen <target>`
+
+Generates IDE integration files.
+
+### vscode
+
+```bash
+dcr gen vscode
+```
+
+Creates:
+- `.vscode/tasks.json` — `build` task (dcr build)
+- `.vscode/launch.json` — debug launch configuration
+- `.vscode/settings.json` — C/C++ settings (clangd paths, includes)
+- `.vscode/extensions.json` — recommended extensions (vscode-clangd, vscode-lldb)
+
+### clion
+
+```bash
+dcr gen clion
+```
+
+Creates:
+- `.idea/externalTools.xml` — external tools (build, run, clean, test)
+- `.idea/customTargets.xml` — custom build targets
+- `.idea/misc.xml` — C/C++ project settings
+- `.idea/runConfigurations/<name>.xml` — per-binary run configurations
+
+### compile-commands
+
+```bash
+dcr gen compile-commands
+```
+
+Generates `compile_commands.json` — standard format for clangd, cpptools, static analyzers.
+
+### project-info
+
+```bash
+dcr gen project-info
+```
+
+Outputs JSON array with project metadata:
+
+```json
+[
+  {
+    "name": "my-app",
+    "version": "0.1.0",
+    "root": "/path/to/project",
+    "profile": "debug",
+    "language": "c",
+    "standard": "c17",
+    "cxx_standard": null,
+    "compiler": "/usr/bin/clang",
+    "kind": "bin",
+    "sources": ["src/main.c"],
+    "include_dirs": ["src"],
+    "lib_dirs": [],
+    "libs": [],
+    "cflags": ["-std=c17", "-O0", "-g"],
+    "ldflags": []
+  }
+]
+```

docs/commands/global-options.md

@@ -1,44 +0,0 @@
-# Global options
-
-## `dcr --help`
-
-```sh
-dcr --help
-```
-
-Prints top-level CLI usage, commands, flags, and examples.
-
-## `dcr --version`
-
-```sh
-dcr --version
-```
-
-Prints:
-
-```text
-dcr <version> (<target>)
-```
-
-## `dcr --update`
-
-```sh
-dcr --update
-```
-
-Update flow:
-
-1. Requests latest release from GitHub API.
-2. Finds asset matching current `DCR_TARGET`.
-3. Downloads replacement binary.
-4. Replaces current executable via `self-replace`.
-
-Limitations and behavior:
-
-- No extra arguments are accepted.
-- Requires network access to GitHub API/assets.
-- On Linux, if binary is owned by pacman, DCR prints package-manager update instructions instead of self-updating.
-
-## Running without command
-
-Running plain `dcr` (without arguments) shows help output.

docs/commands/project-commands.mdx

@@ -0,0 +1,30 @@
+---
+sidebar_label: Project commands (new, init)
+---
+
+# Project Commands
+
+## `dcr new <name>`
+
+Creates a new project with a standard structure and `dcr.toml`. The `name` argument is required.
+
+Only ASCII letters, digits, underscores `_` and hyphens `-` are allowed in the project name.
+
+```bash
+dcr new my-app
+```
+
+Generates:
+- `dcr.toml` with basic fields
+- `src/main.c` with a `main` template
+
+## `dcr init`
+
+Initializes a DCR project in the current (empty) directory.
+
+```bash
+mkdir app && cd app
+dcr init
+```
+
+The project name is taken from the current directory name. The directory name must follow the same naming rules as `dcr new`.

docs/commands/quality-commands.mdx

@@ -0,0 +1,44 @@
+---
+sidebar_label: Quality commands (test, fmt)
+---
+
+# Quality Commands
+
+## `dcr test`
+
+Runs tests.
+
+```bash
+dcr test                          # debug profile
+dcr test --release                # release profile
+dcr test --debug                  # explicit debug
+dcr test --help                   # detailed help
+```
+
+Before first use, initialize tests:
+
+```bash
+dcr test --init
+```
+
+This creates `tests/dcr_test.h` (framework) and `tests/test.c` (template).
+
+What `dcr test` does:
+1. Builds the project
+2. Collects `tests/*.c` files (`.c` only, not `.cpp`)
+3. Compiles and links each test file
+4. Runs each test binary
+5. Prints summary: TOTAL, PASS, SKIP, FAIL
+6. Returns non-zero exit code on any FAIL
+
+## `dcr fmt`
+
+Formats C/C++ source files using `clang-format`.
+
+```bash
+dcr fmt
+```
+
+Processes: `src/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}` and `tests/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}`.
+
+Uses `.clang-format` at the project root (if present), otherwise default clang-format style.

docs/commands/system-commands.mdx

@@ -0,0 +1,50 @@
+---
+sidebar_label: System commands (setup, --help, ...)
+---
+
+# System Commands
+
+## `dcr setup`
+
+Shows configured registries from `~/.dcr/config.toml`.
+
+```bash
+dcr setup
+```
+
+If `~/.dcr/config.toml` is not found, DCR returns an error. Create it manually:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+## `dcr --help`
+
+Shows help for all commands.
+
+```bash
+dcr --help
+```
+
+## `dcr --version`
+
+Shows version and target triple.
+
+```bash
+dcr --version       # dcr 0.7.0 (x86_64-unknown-linux-gnu)
+```
+
+## `dcr --update`
+
+Self-update. Downloads the latest release binary from GitHub Releases and replaces the current one.
+
+```bash
+dcr --update
+```
+
+Features:
+- Auto-detects platform and architecture
+- Warns if installed via AUR (use package manager instead)
+- Works on Linux, macOS, Windows

docs/configuration/build-profiles.md

@@ -1,85 +0,0 @@
-# Build profiles
-
-DCR supports two profiles:
-
-- `debug` (default)
-- `release`
-
-## How to select
-
-```sh
-dcr build --debug
-dcr build --release
-dcr run --release
-dcr clean --debug
-```
-
-You can also add `--force` or `--clean` to `build`/`run`.
-
-## Default profile flags
-
-### GCC/Clang-like toolchains
-
-- `debug`: `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG`
-- `release`: `-O3 -DNDEBUG`
-
-### MSVC toolchain
-
-- `debug`: `/Od /Zi /W4 /DDCR_DEBUG /Oy-`
-- `release`: `/O2 /DNDEBUG`
-
-## Artifacts
-
-By default (for `kind = "bin"`):
-
-- `target/<target>/debug/<name>` (or `.exe` on Windows)
-- `target/<target>/release/<name>` (or `.exe` on Windows)
-
-Where `<target>` is `native` or a target triple.  
-Use `build.out_dir` to override the output directory.
-
-Default compiler flags:
-
-GCC/Clang:
-
-- `debug`: `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG`
-- `release`: `-O3 -DNDEBUG`
-
-MSVC:
-
-- `debug`: `/Od /Zi /W4 /DDCR_DEBUG /Oy-`
-- `release`: `/O2 /DNDEBUG`
-
-Static library mode (`kind = "staticlib"`):
-
-- Linux/macOS: `lib<name>.a`
-- Windows: `<name>.lib`
-
-Shared library mode (`kind = "sharedlib"`):
-
-- Linux: `lib<name>.so`
-- macOS: `lib<name>.dylib`
-- Windows: `<name>.dll`
-
-UEFI executable mode (`kind = "efi"`):
-
-- All platforms: `<name>.efi`
-
-Bare-metal ELF mode (`kind = "elf"`):
-
-- All platforms: `<name>` (no extension)
-
-## Profile overrides
-
-Use `[build.debug]` and `[build.release]` to override build settings per profile.
-All values inherit from `[build]`. If a field is present in the profile table, it replaces the base value.
-For arrays (like `cflags`/`ldflags`), the profile value is appended to the base array.
-
-```toml
-[build.debug]
-cflags = ["-g3"]
-
-[build.release]
-cflags = ["-O3"]
-ldflags = ["-s"]
-```

docs/configuration/build-section.md

@@ -1,180 +0,0 @@
-# Build section
-
-## Schema
-
-```toml
-[build]
-language = "c"
-standard = "c11"
-compiler = "clang"
-kind = "bin"
-# filename = "KERNEL"
-# extension = "BIN"
-# optional:
-# inherit = true  # Inherit from base (default true)
-# targets = ["linux", "macos"]  # Multiple targets to build
-# out_dir = "./dist"
-# target = "x86_64-unknown-linux-gnu"
-# platform = "x86_64"
-# cflags = ["-Wall"]
-# ldflags = ["-lm"]
-# exclude = ["src/vendor", "src/legacy/**"]
-# include = ["src/legacy/boot/**"]
-# roots = ["kernel", "drivers"]
-# src_disable = true
-# pkg_config = ["Qt6Core", "Qt6Widgets"]
-# generated = ["src/ui/*.h"]
-# expect = ["./target/{profile}/boot/*.bin"]
-# clean = ["./target/{profile}/boot", "/tmp/image/*.img"]
-```
-
-## Fields
-
-- `language` (string or array, required): `c`, `c++`, `cpp`, `cxx`, or `asm`.
-  Mixed languages can be specified as an array, for example `["c", "c++", "asm"]`.
-- `standard` (string, optional): C language standard passed to compiler (e.g. `c11`, `c17`, `gnu11`). Defaults to `c11`.
-- `cxx_standard` (string, optional): C++ language standard passed to compiler for `.cpp`/`.cxx`/`.cc` files
-  (e.g. `c++17`, `gnu++17`, `c++20`). When set, overrides `standard` for C++ sources.
-- `compiler` (string, required): compiler command (for example `clang`, `gcc`, `cl`).
-- `kind` (string, optional): `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, or `custom`. Defaults to `bin`.
-- `filename` (string, optional): custom output filename (without extension). Overrides `package.name` for the final artifact.
-- `extension` (string, optional): custom file extension without the leading dot (e.g. `BIN`, `efi`, `EFI`). Combined with `filename`.
-- `inherit` (bool, optional): inherit settings from base `[build]` (default `true`). If `false`, only use target/profile specific settings.
-- `targets` (string array, optional): list of targets to build simultaneously. Supports short names (`linux`, `macos`, `windows`).
-- `target` (string, optional): platform target triple (e.g. `x86_64-unknown-linux-gnu`) or short name (`linux`, `macos`, `windows`). Same as `--target` CLI flag.
-- `out_dir` (string, optional): custom output directory for final artifact (overrides default `target/<target>/<profile>/`).
-- `platform` (string, optional): architecture hint for compiler (used for `-march` or `/arch`).
-- `cflags` (string array, optional): extra compile flags.
-  Supports variable substitution — see [Variable substitution](#variable-substitution) below.
-- `ldflags` (string array, optional): extra link flags.
-  Supports variable substitution — see [Variable substitution](#variable-substitution) below.
-- `ldscript` (string, optional): linker script path. Passed as `-T <path>` to the linker. Useful for bare-metal/embedded/freestanding targets.
-- `exclude` (string array, optional): paths or glob patterns to skip during source/header collection.
-- `include` (string array, optional): allowlist paths or globs that override `exclude`.
-- `include` directory entries (non-glob) are also passed to the compiler as `-I` include paths.
-- `roots` (string array, optional): additional source roots to scan instead of `src/`.
-- `src_disable` (bool, optional): disables default `src/` root when true.
-- `pkg_config` (string array, optional): packages used to append `pkg-config --cflags/--libs`.
-- `generated` (string array, optional): generated files to delete when build steps rerun.
-- `expect` (string array, optional): artifacts that must exist after build/post-steps.
-- `clean` (string array, optional): additional paths removed by `dcr clean` and `--clean`.
-
-Notes for `exclude`/`include`:
-- Supports `*` and `**` glob patterns.
-- If `include` is set, it has priority over `exclude`.
-- Use `include` to re-allow nested paths, for example exclude `src/boot` but allow `src/boot/arch/**`.
-When using glob patterns in `exclude`, DCR converts them internally, so `exclude` globs still work as expected.
-
-### Variable substitution
-
-`cflags`, `ldflags`, and `include` directory entries support the same `{placeholder}` variables
-as build/post steps:
-
-| Variable | Description |
-|---|---|
-| `{profile}` | Build profile (`debug` / `release`) |
-| `{name}` | Package name |
-| `{version}` | Full package version (e.g. `0.2.1`) |
-| `{version_major}` | Major version number |
-| `{version_minor}` | Minor version number |
-| `{version_patch}` | Patch version number |
-| `{version_suffix}` | Version suffix (e.g. `-rc1`) |
-| `{version_suffix_dash}` | Suffix with leading dash (or empty) |
-
-Example:
-
-```toml
-[build]
-cflags = ['-DPROJECT_VERSION="{version}"', '-DVERSION_MAJOR={version_major}']
-```
-
-## Build steps
-
-```toml
-[[build.steps]]
-name = "uic"
-in = "src/ui/*.ui"
-out = "src/ui/{stem}.h"
-cmd = "{uic} {in} -o {out}"
-
-[[build.post_steps]]
-name = "image"
-in = "target/{profile}/boot/*.bin"
-out = "/tmp/image/os-{version}.img"
-cmd = "dd if=/dev/zero of={out} bs=1M count=8"
-```
-
-Step notes:
-- `in` supports glob patterns.
-- If `in` expands to multiple files, `out` must include `{stem}`.
-- Steps run only when inputs are newer than outputs.
-- Variables: `{in}`, `{out}`, `{stem}`, `{cflags}`, `{uic}`, `{moc}`, `{rcc}`, `{profile}`,
-  `{version}`, `{version_major}`, `{version_minor}`, `{version_patch}`, `{version_suffix}`, `{version_suffix_dash}`.
-
-`build.clean` supports `{profile}` and version placeholders (`{version}`, `{version_major}`, ...).
-
-### Profile overrides
-
-Profile tables inherit all values from `[build]`. Any field present in the profile table replaces the base value.
-Array fields (like `cflags`/`ldflags`) are appended to the base array.
-
-Target tables override profile and base settings for specific targets. Full inheritance order:
-1. `[build.<target>.<profile>]`
-2. `[build.<profile>.<target>]`
-3. `[build.<target>]`
-4. `[build.<profile>]`
-5. `[build]`
-
-If custom `cflags` are set (non-empty), default compiler flags are disabled.
-
-```toml
-[build.debug]
-cflags = ["-g3"]
-
-[build.release]
-cflags = ["-O3"]
-ldflags = ["-s"]
-
-# Target-specific overrides (applied after profile)
-[build.linux]
-compiler = "gcc"
-cflags = ["-march=x86_64"]
-
-[build.macos]
-compiler = "clang"
-cflags = ["-arch", "x86_64"]
-
-# Full inheritance example
-[build.linux.release]
-cflags = ["-O3", "-march=native"]  # Overrides profile and base
-
-[build.release.linux]
-ldflags = ["-static"]  # Alternative order
-
-[build.windows.debug]
-compiler = "x86_64-w64-mingw32-gcc"
-cflags = []  # Empty to disable defaults
-
-[build.release]
-inherit = false  # No inheritance, only explicit settings
-```
-
-## Toolchain section
-
-```toml
-[toolchain]
-cc = "clang"
-cxx = "clang++"
-as = "as"
-ar = "ar"
-ld = "ld"
-uic = "uic"
-moc = "moc"
-rcc = "rcc"
-```
-
-## Behavior notes
-
-- Compiler backend is selected by compiler string (`gcc`, `clang`, `cl`, `clang-cl`).
-- Empty or unknown compiler value falls back to clang-like build path.
-- `run` is not allowed for library kinds (`staticlib`, `sharedlib`), `efi`, or `elf`.

docs/configuration/dcr.toml-overview.md

@@ -1,70 +0,0 @@
-# dcr.toml overview
-
-`dcr.toml` is the main project file used by DCR.
-
-## Minimal generated template
-
-```toml
-[package]
-name = "hello"
-version = "0.1.0"
-
-[build]
-language = "c"
-standard = "c11"
-compiler = "clang"
-kind = "bin"
-
-[dependencies]
-```
-
-`dcr new` and `dcr init` generate this structure automatically.
-
-## Required sections
-
-- `[package]`
-- `[build]`
-- `[dependencies]`
-
-Workspace-only root:
-- `[workspace]` can be added to a normal root config to define members and dependency order.
-- Root config still requires `[package]`, `[build]`, and `[dependencies]`.
-
-## Required keys
-
-- `package.name`
-- `package.version`
-- `build.language`
-- `build.compiler`
-
-## Optional keys
-
-- `build.standard` (default: `c11`)
-- `build.kind` (default: `bin`; valid: `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom`)
-- `build.inherit`
-- `build.targets`
-- `build.target`
-- `build.out_dir`
-- `build.platform`
-- `build.cflags`
-- `build.ldflags`
-- `build.exclude`
-- `build.include`
-- `build.roots`
-- `build.src_disable`
-- `build.pkg_config`
-- `build.steps`
-- `build.post_steps`
-- `build.generated`
-- `build.expect`
-- `build.clean`
-- `build.debug`
-- `build.release`
-- `build.<target>` (target-specific overrides)
-- dependency fields (`include`, `lib`, `libs`, `system`)
-- `[toolchain]` overrides (`cc`, `cxx`, `as`, `ar`, `ld`, `uic`, `moc`, `rcc`)
-- `[toolchain.<target>]` (target-specific toolchain)
-- `[workspace]` members
-- `[workspace.<target>]` (target-specific workspace)
-- `[run]` overrides (`cmd`)
-- `[run.<target>]` (target-specific run)

docs/configuration/dependencies-section.md

@@ -1,46 +0,0 @@
-# Dependencies section
-
-DCR supports registry-based dependencies and path dependencies.
-
-## Example
-
-```toml
-[dependencies]
-# Registry dependency
-mylib = "0.1.0"
-# Git dependency
-json = { git = "https://github.com/nlohmann/json", tag = "v3.11.2" }
-# Path dependency
-frecli = { path = "./lib/frecli", include = ["."], lib = ["."], libs = ["frecli"] }
-```
-
-## Supported dependency types
-
-### Registry dependencies
-Defined by name and version string. DCR automatically resolves the package from the configured registry index.
-- `version` (string, required): version requirement.
-- `features` (string array, optional): enable specific features.
-
-### Git dependencies
-Defined by repository URL and optionally branch, tag, or revision.
-- `git` (string, required): repository URL.
-- `branch`, `tag`, `rev` (string, optional): Git reference.
-
-### Path dependencies
-- `path` (string, required): absolute path or path relative to project root.
-- `include` (string array, optional): include directories inside dependency.
-- `lib` (string array, optional): library directories inside dependency.
-- `libs` (string array, optional): library names for linker.
-
-## Defaults for path dependencies
-
-- If `include` is omitted, DCR tries `<dep>/include`.
-- If `lib` is omitted, DCR tries `<dep>/lib`, then `<dep>/lib64`.
-- If `libs` is omitted, dependency key name is used.
-
-## Validation
-
-- Dependency value must be a string (registry) or a TOML table (path).
-- Registry dependencies use the version string to match versions in the registry.
-- `path` is mandatory for path dependencies.
-- `include`/`lib`/`libs` must be arrays of strings if provided.

docs/configuration/package-section.md

@@ -1,35 +0,0 @@
-# Package section
-
-## Schema
-
-```toml
-[package]
-name        = "my-app"
-version     = "0.1.0"
-type        = "app"
-description = "My application"
-author      = "John Doe"
-license     = "MIT"
-```
-
-## Fields
-
-- `name` (string, required): used as output artifact base name.
-- `version` (string, required): used in `dcr.lock` project entry.
-- `type` (string, optional): project type (`app`, `lib`, `none`).
-- `description` (string, optional): human-readable project description.
-- `author` (string, optional): single author name.
-- `authors` (array of strings, optional): list of authors.
-- `license` (string, optional): project license identifier (e.g. `MIT`, `GPL-3.0-or-later`).
-- `homepage` (string, optional): project homepage URL.
-- `repository` (string, optional): source repository URL.
-- `readme` (string, optional): path to README file.
-- `keywords` (array of strings, optional): project keywords.
-- `categories` (array of strings, optional): project categories.
-
-## Notes
-
-- Empty `name` or `version` makes config invalid.
-- `dcr new` sets `name` from the passed project name.
-- `dcr init` sets `name` from current directory name.
-- If `type = "lib"`, DCR generates `include/` and `lib/` directories in the target path, copying public headers and built libraries.

docs/contributing.mdx

@@ -0,0 +1,50 @@
+---
+sidebar_label: Contributing
+---
+
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/dexoron/dcr
+cd dcr
+cargo build
+```
+
+## Code style
+
+All code must be formatted with `cargo fmt`:
+
+```bash
+cargo fmt
+```
+
+## Linting
+
+```bash
+cargo clippy --all-targets -- -D warnings
+```
+
+## Tests
+
+```bash
+cargo test --all-targets
+```
+
+## PR process
+
+1. Fork the repository
+2. Create a branch: `git checkout -b feature/description`
+3. Make changes
+4. Run `cargo fmt && cargo clippy && cargo test`
+5. Open a Pull Request
+
+## CI
+
+CI runs:
+- `cargo fmt --check`
+- `cargo clippy --all-targets -- -D warnings`
+- `cargo test --all-targets`
+- Build on Linux, macOS, Windows
+- Integration tests

docs/dependencies-and-build/compilers-and-linking.md

@@ -1,78 +0,0 @@
-# Compilers & linking
-
-## Compiler backend selection
-
-DCR picks a backend from `build.compiler`:
-
-- contains `clang-cl` -> MSVC backend
-- equals `as` or contains `gas` -> GAS backend (standalone assembler)
-- contains `gcc` or `g++` -> GCC backend
-- contains `clang` or `clang++` -> Clang backend
-- equals `cl` or contains `msvc` -> MSVC backend
-- contains `nasm` -> NASM backend
-- otherwise -> Clang backend fallback
-
-## Compilation model
-
-- Source files are found recursively in `src/` based on `build.language`.
-- `build.roots` and `build.src_disable` can replace the default `src/` root.
-- Mixed language builds use arrays, for example `build.language = ["c", "asm"]`.
-- Each source is compiled to `target/<target>/<profile>/obj/<relative-path>.o` (`.obj` on MSVC, where `<target>` is `native` or target triple).
-- Recompile happens when source mtime is newer than object mtime.
-- `build.exclude` removes paths from source/header collection; `build.include` re-allows matching paths and has priority over `exclude`.
-
-## Default build flags
-
-These flags are applied automatically based on profile and compiler backend.
-
-GCC/Clang:
-
-- `debug`: `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG`
-- `release`: `-O3 -DNDEBUG`
-
-MSVC:
-
-- `debug`: `/Od /Zi /W4 /DDCR_DEBUG /Oy-`
-- `release`: `/O2 /DNDEBUG`
-
-Note: If custom `cflags` are set in `dcr.toml`, default profile flags are disabled to allow full control.
-
-## Platform hint
-
-If `build.platform` is set, DCR passes it as an architecture hint:
-
-- GCC/Clang: `-march=<platform>`
-- MSVC: maps to `/arch:*` for known values (`x86`, `i386`, `i486`, `i586`, `i686`, `sse2`, `avx`, `avx2`)
-
-## Toolchain overrides
-
-If `[toolchain]` is set, DCR uses its values to override compiler/linker tools:
-
-- `cc`, `cxx`, `as` override compilers for C/C++/ASM
-- `ar` overrides the archiver (used for `staticlib`)
-- `ld` overrides the linker (used by GCC/Clang/NASM/GAS backends)
-- `uic`, `moc`, `rcc` override Qt tools used in `build.steps`
-
-Environment overrides (highest priority):
-- `DCR_COMPILER` (all languages)
-- `DCR_CC`, `DCR_CXX`, `DCR_AS`, `DCR_AR`, `DCR_LD`
-- `DCR_DEBUG` enables verbose build logging
-
-## Linking
-
-For `kind = "bin"`:
-
-- Object files are linked into executable artifact.
-- Dependency lib dirs and library names are passed to linker.
-- `build.ldflags` are appended to link command.
-
-For `kind = "staticlib"`:
-
-- Linux/macOS (GCC/Clang): `ar rcs` creates `.a` archive.
-- Windows (MSVC): `lib` creates `.lib` archive.
-
-For `kind = "sharedlib"`:
-
-- Linux (GCC/Clang): `-shared` with output `.so`.
-- macOS (Clang): `-dynamiclib` with output `.dylib`.
-- Windows (MSVC): `/LD` with output `.dll`.

docs/dependencies-and-build/cross-compilation.md

@@ -1,219 +0,0 @@
-# Cross-compilation and Targets
-
-DCR supports cross-compilation to different platforms using the `--target` flag. This allows building your project for architectures and operating systems different from the host.
-
-## Basic Usage
-
-```bash
-# Build for a specific target
-dcr build --target x86_64-unknown-linux-gnu --release
-
-# Short names for common platforms
-dcr build --target linux --release    # x86_64-unknown-linux-gnu
-dcr build --target macos --release    # x86_64-apple-darwin
-dcr build --target windows --release  # x86_64-pc-windows-msvc
-
-# Run for a specific target
-dcr run --target linux --release
-```
-
-## Supported Targets
-
-### Short Names
-- `linux` → `x86_64-unknown-linux-gnu`
-- `macos` → `x86_64-apple-darwin`
-- `windows` → `x86_64-pc-windows-msvc`
-- `freebsd` → `x86_64-unknown-freebsd`
-- `openbsd` → `x86_64-unknown-openbsd`
-- `netbsd` → `x86_64-unknown-netbsd`
-
-### Full Target Triples
-DCR supports any valid target triple in the format `<arch>-<vendor>-<os>-<abi>`. Common examples:
-- `x86_64-unknown-linux-gnu`
-- `aarch64-linux-gnu`
-- `x86_64-apple-darwin`
-- `aarch64-apple-darwin`
-- `x86_64-pc-windows-msvc`
-- `i686-pc-windows-gnu`
-- `x86_64-unknown-freebsd`
-- `x86_64-unknown-openbsd`
-- `x86_64-unknown-netbsd`
-
-## Configuration
-
-### Multiple Targets
-
-Configure multiple targets to build simultaneously:
-
-```toml
-[build]
-targets = ["linux", "macos", "windows"]
-
-# Or per profile
-[build.release]
-targets = ["linux", "macos"]
-```
-
-If no `--target` is specified, DCR builds for all targets in `build.targets` (or native if empty).
-
-### Target-Specific Settings
-
-Override settings for specific targets:
-
-```toml
-[build.linux]
-compiler = "gcc"
-cflags = ["-Wall", "-O2"]
-
-[build.macos]
-compiler = "clang"
-cflags = ["-Wall", "-O2", "-arch", "x86_64"]
-
-[build.windows]
-compiler = "x86_64-w64-mingw32-gcc"
-ldflags = ["-static"]
-
-[build.freebsd]
-compiler = "clang"
-cflags = ["-Wall", "-O2"]
-```
-
-### Target-Specific Toolchain
-
-Configure toolchain per target:
-
-```toml
-[toolchain.linux]
-cc = "gcc"
-ld = "ld"
-
-[toolchain.macos]
-cc = "clang"
-ld = "ld"
-
-[toolchain.windows]
-cc = "x86_64-w64-mingw32-gcc"
-ld = "x86_64-w64-mingw32-ld"
-```
-
-### Target-Specific Run Commands
-
-Use custom run commands per target:
-
-```toml
-[run.linux]
-cmd = "./target/linux/release/myapp"
-
-[run.macos]
-cmd = "open ./target/macos/release/myapp.app"
-
-[run.windows]
-cmd = "wine ./target/windows/release/myapp.exe"
-
-[run.freebsd]
-cmd = "./target/freebsd/release/myapp"
-```
-
-## Workspace and Dependencies Inheritance
-
-Workspace and dependencies sections also support target/profile inheritance:
-
-```toml
-[workspace.linux]
-members = [
-  { name = "lib1", path = "libs/lib1" },
-]
-
-[dependencies.linux]
-sdl2 = { system = true, include = ["/usr/include/SDL2"] }
-
-[dependencies.windows]
-sdl2 = { system = true, include = ["C:/SDL2/include"] }
-```
-
-Order: `workspace.target.profile` → `workspace.profile.target` → `workspace.target` → `workspace.profile` → `workspace`.
-
-Add `inherit = false` to disable inheritance in any section.
-
-Settings are applied in order:
-1. `[build.<target>]`
-2. `[build.<profile>]`
-3. `[build]`
-
-### Toolchain Configuration
-
-For cross-compilation, configure toolchains:
-
-```toml
-[toolchain]
-cc = "aarch64-linux-gnu-gcc"
-cxx = "aarch64-linux-gnu-g++"
-ar = "aarch64-linux-gnu-ar"
-ld = "aarch64-linux-gnu-ld"
-```
-
-## Output Structure
-
-Build outputs are organized by target:
-
-```
-target/
-├── native/
-│   ├── debug/
-│   └── release/
-├── x86_64-unknown-linux-gnu/
-│   ├── debug/
-│   └── release/
-├── aarch64-linux-gnu/
-│   ├── debug/
-│   └── release/
-└── x86_64-unknown-freebsd/
-    ├── debug/
-    └── release/
-```
-
-## Requirements
-
-- Cross-compilation requires appropriate toolchains installed (e.g., `aarch64-linux-gnu-gcc` on Arch Linux).
-- For Windows targets on Linux, install MinGW: `pacman -S mingw-w64-gcc`.
-- For macOS targets on Linux, use `osxcross` or similar.
-
-## Examples
-
-### ARM Linux Build
-
-```bash
-# Install toolchain (Arch Linux)
-pacman -S aarch64-linux-gnu-gcc
-
-# Configure
-echo '[build.aarch64-linux-gnu]
-compiler = "aarch64-linux-gnu-gcc"' >> dcr.toml
-
-# Build
-dcr build --target aarch64-linux-gnu --release
-```
-
-**Note:** If you set `target = "aarch64-linux-gnu"` (or any value) directly under `[build]`, DCR will automatically add `--target=...` to cflags when using clang. You usually don't need to repeat it manually.
-
-### Windows Build on Linux
-
-```bash
-# Install toolchain (Arch Linux)
-pacman -S mingw-w64-gcc
-
-# Configure
-echo '[build.windows]
-compiler = "x86_64-w64-mingw32-gcc"' >> dcr.toml
-
-# Build
-dcr build --target windows --release
-```
-
-## Troubleshooting
-
-- **Toolchain not found**: Ensure the compiler is installed and in PATH, or configure `[toolchain]` in `dcr.toml`. For Arch Linux: `pacman -S aarch64-linux-gnu-gcc` for ARM, `pacman -S mingw-w64-gcc` for Windows cross-compilation.
-- **Linking errors**: Check `ldflags` and library paths for cross-compilation.
-- **Header issues**: Include paths may differ; use target-specific `cflags`.
-
-For more help, see [Troubleshooting map](../reference-and-help/troubleshooting-map.md).

docs/dependencies-and-build/dependency-format.md

@@ -1,44 +0,0 @@
-# Dependency format
-
-Dependencies are defined in `dcr.toml` under `[dependencies]`.
-
-## Full example (Path)
-
-```toml
-[dependencies]
-fmt = { path = "./third_party/fmt", include = ["include"], lib = ["lib"], libs = ["fmt"] }
-```
-
-## Full example (Git)
-
-```toml
-[dependencies]
-json = { git = "https://github.com/nlohmann/json", tag = "v3.11.2" }
-```
-
-## Field reference
-
-- `path`: local path to dependency root.
-- `git`: URL of Git repository.
-- `branch`: Git branch name.
-- `tag`: Git tag name.
-- `rev`: Git commit SHA.
-- `include`: optional include subpaths (absolute or relative to dep root).
-- `lib`: optional library subpaths (absolute or relative to dep root).
-- `libs`: optional linker library names.
-- `features`: optional feature flags for registry dependencies.
-- `default-features`: whether to include default features (default `true`).
-
-## Common valid compact forms
-
-```toml
-[dependencies]
-mylib = { path = "./libs/mylib" }
-gitlib = { git = "https://github.com/user/repo" }
-# Shortest form for path
-simple = "./libs/simple"
-# Registry with features
-sdl2 = { version = "2.0.0", features = ["vulkan"] }
-```
-
-In these forms DCR will try defaults for include/lib dirs and use the dependency name as the linker library name.

docs/dependencies-and-build/local-dependencies.md

@@ -1,24 +0,0 @@
-# Local dependencies
-
-## Resolution flow during build
-
-For each dependency in `[dependencies]`, DCR:
-
-1. Resolves `path` (absolute or project-relative).
-2. Resolves include dirs (`include` or default `include`).
-3. Resolves lib dirs (`lib` or defaults `lib`, `lib64`).
-4. Resolves link libs (`libs` or dependency name).
-5. Synchronizes dependency files to `target/<profile>/deps/<dep-name>/`.
-6. Adds include/lib/link options to compile/link commands.
-
-### Profile placeholders
-
-`path`, `include`, and `lib` entries may use `{profile}` which expands to the active profile
-(`debug` or `release`).
-
-## Failure cases
-
-- Dependency path is missing or not a directory.
-- No valid include/lib directories were found.
-- Any configured include/lib path does not exist.
-- Invalid field types in dependency config.

docs/dependencies-and-build/target-directory.md

@@ -1,30 +0,0 @@
-# Target directory
-
-By default, DCR writes final artifacts to `target/<target>/<profile>/` (where `<target>` is `native` or target triple).
-
-You can override this with `build.out_dir`:
-
-```toml
-[build]
-out_dir = "./dist"
-```
-
-## Behavior
-
-- Binary mode:
-  - Linux/macOS: `<out_dir>/<name>`
-  - Windows: `<out_dir>/<name>.exe`
-- Static library mode:
-  - Linux/macOS: `<out_dir>/lib<name>.a`
-  - Windows: `<out_dir>/<name>.lib`
-
-## Important detail
-
-`build.out_dir` changes only the final artifact location. Object cache and dependency sync directories still use `target/<target>/<profile>/...`.
-
-## Distinction from platform targets
-
-- `build.out_dir` — custom **output directory** path.
-- `build.target` / `--target <triple>` CLI flag — **platform target** for cross-compilation (e.g. `x86_64-unknown-linux-gnu`, or short name `linux`).
-- `build.targets` (array) — list of **platform targets** to build simultaneously.
-- `[build.<target>]` sections — **target-specific config overrides** (e.g. `[build.linux]`).

docs/dependencies-and-build/versioning-and-lock-file.md

@@ -1,32 +0,0 @@
-# Versioning & lock file
-
-DCR generates `dcr.lock` when dependency resolution succeeds and at least one dependency exists.
-
-## What is stored
-
-- Project entry (`name`, `version`, dependency names).
-- One entry per resolved dependency:
-  - `name`
-  - `version` (from dependency `dcr.toml`, fallback `0.0.0`)
-  - `source` (`path+...`)
-  - `checksum` (SHA-256 over dependency files, excluding nested `target/`).
-
-## Example shape
-
-```toml
-[[package]]
-name = "my-app"
-version = "0.1.0"
-dependencies = ["fmt"]
-
-[[package]]
-name = "fmt"
-version = "1.2.3"
-source = "path+./third_party/fmt"
-checksum = "..."
-```
-
-## Notes
-
-- `dcr.lock` is rewritten on successful dependency resolution.
-- If `[dependencies]` is empty, lock generation is skipped.

docs/faq.mdx

@@ -0,0 +1,81 @@
+---
+sidebar_label: FAQ
+---
+
+# FAQ
+
+## Registry not found
+
+```
+error: registry not found
+```
+
+**Solution:** Make sure `~/.dcr/config.toml` exists:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+And check `DCR_INDEX_PATH`:
+
+```bash
+echo $DCR_INDEX_PATH
+```
+
+## Compiler not found
+
+```
+error: compiler not found
+```
+
+**Solution:** Ensure a compiler is installed and available in PATH.
+
+```bash
+which gcc
+which clang
+```
+
+Or specify explicitly via `[toolchain]` in `dcr.toml`.
+
+## openssl-sys build failed
+
+When building DCR from source:
+
+```
+error: failed to run custom build command for openssl-sys
+```
+
+**Solution:** Install OpenSSL development headers:
+
+```bash
+# Ubuntu/Debian
+sudo apt install libssl-dev
+
+# Fedora
+sudo dnf install openssl-devel
+
+# macOS
+brew install openssl
+```
+
+## Ctrl+C during build
+
+DCR handles SIGINT: interrupts the current compilation and exits with non-zero code.
+
+## How to create a library?
+
+See [Library Recipe](/docs/recipes/library-project).
+
+## How to cross-compile to Windows?
+
+See [Cross-Compile Recipe](/docs/recipes/cross-to-windows).
+
+## How to create a multi-package project?
+
+See [Workspace Recipe](/docs/recipes/multi-package-workspace).
+
+## Lock file
+
+`dcr.lock` is created during builds (`dcr build`) when registry dependencies are present. To force an update — delete `dcr.lock` and run `dcr build`.

docs/getting-started/build-and-run.md

@@ -1,57 +0,0 @@
-# Build and run
-
-## Build
-
-Debug (default):
-
-```sh
-dcr build
-# or
-dcr build --debug
-dcr build --target linux --debug
-dcr build --debug --clean
-```
-
-Release:
-
-```sh
-dcr build --release
-dcr build --target windows --release
-```
-
-## Run
-
-```sh
-dcr run
-# or
-dcr run --target macos
-dcr run --release
-dcr run --target linux --release
-dcr run --release --force
-```
-
-`dcr run` first builds, then launches the produced binary.
-
-## Clean artifacts
-
-```sh
-dcr clean
-```
-
-Profile-only cleanup:
-
-```sh
-dcr clean --debug
-dcr clean --release
-dcr clean --all
-dcr clean --release --all
-```
-
-## Notes
-
-- `run` is unavailable for `build.kind = "staticlib"`, `build.kind = "sharedlib"`, `build.kind = "efi"`, and `build.kind = "elf"`.
-- Build profile flag (`--debug` / `--release`) can be passed in any argument position.
-- Unknown profile flags produce an error.
-- In workspace root, `clean --all` cleans all member projects.
-- `--target` builds/runs for specified target (short names: `linux`, `macos`, `windows`).
-- `--clean` for `build`/`run` removes `target/<target>/<profile>` and paths from `build.clean`.

docs/getting-started/create-your-first-project.md

@@ -1,41 +0,0 @@
-# Create your first project
-
-## Create in a new folder
-
-```sh
-dcr new hello
-cd hello
-```
-
-This creates:
-
-```text
-hello/
-- dcr.toml
-- src/
-- - main.c
-```
-
-## Or initialize current folder
-
-```sh
-mkdir hello
-cd hello
-dcr init
-```
-
-`dcr init` requires the current directory to be empty.
-
-## Next steps
-
-Build and run:
-
-```sh
-dcr run
-```
-
-Release build/run:
-
-```sh
-dcr run --release
-```

docs/getting-started/first-steps.mdx

@@ -0,0 +1,70 @@
+---
+sidebar_label: First steps
+---
+
+# First Steps
+
+## Create a project
+
+```bash
+dcr new my-app
+cd my-app
+```
+
+Structure:
+
+```
+my-app/
+├── dcr.toml
+└── src/
+    └── main.c
+```
+
+`dcr.toml`:
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+compiler = "clang"
+kind = "bin"
+```
+
+## Build
+
+```bash
+dcr build
+```
+
+Output — `target/<triple>/debug/my-app` (Linux) or `target/debug/my-app.exe` (Windows).
+
+Build profiles:
+```bash
+dcr build --release       # release build
+dcr build --debug         # debug (default)
+```
+
+## Run
+
+```bash
+dcr run
+```
+
+Builds (if needed) and runs the binary.
+
+## First test
+
+```bash
+dcr test --init      # create test template
+dcr test             # run tests
+```
+
+## Formatting
+
+```bash
+dcr fmt              # clang-format with .clang-format
+```

docs/getting-started/installation.md

@@ -1,56 +0,0 @@
-# Installation
-
-## Option 1: Install via script
-
-### Linux/macOS
-
-```sh
-curl -fsSL https://dcr.dexoron.su/install.sh | bash
-```
-
-Alternative with `wget`:
-
-```sh
-wget -qO- https://dcr.dexoron.su/install.sh | bash
-```
-
-### Windows (PowerShell)
-
-```powershell
-powershell -ExecutionPolicy ByPass -c "irm https://dcr.dexoron.su/install.ps1 | iex"
-```
-
-## Option 2: Build from source
-
-```sh
-git clone https://github.com/dexoron/dcr.git
-cd dcr
-cargo build --release
-mkdir -p ~/.local/bin
-ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
-```
-
-## Option 3: Arch Linux (AUR)
-
-```sh
-yay -S dcr
-```
-
-(You can also use `paru` or other AUR helpers.)
-
-## Verify installation
-
-```sh
-dcr --version
-```
-
-Expected format:
-
-```text
-dcr <version> (<target>)
-```
-
-## Update policy
-
-- If DCR was installed from GitHub releases, scripts, or manual build: use `dcr --update`.
-- If DCR is managed by `pacman/AUR`: update via package manager. On Linux, `dcr --update` detects pacman-owned binaries and prints a package-manager hint.

docs/getting-started/installation.mdx

@@ -0,0 +1,106 @@
+---
+sidebar_label: Installation
+---
+
+# Installation
+
+## Linux (Dexoron Packages)
+
+Configure your package manager at https://dcr.dexoron.su and install:
+
+**Arch Linux**
+```sh
+sudo pacman -Sy dcr
+```
+
+**Debian/Ubuntu**
+```sh
+sudo apt update && sudo apt install dcr
+```
+
+**Fedora/RHEL**
+```sh
+sudo dnf install dcr
+```
+
+## Arch Linux (AUR)
+
+```sh
+yay -S dcr
+```
+
+## macOS / Linux (Homebrew)
+
+```sh
+brew tap dexoron/dexoron
+brew install dcr
+```
+
+## Snap (Linux)
+
+```sh
+sudo snap install dcrup
+```
+
+## Nix (flake)
+
+```sh
+nix run github:dexoron/dcr
+# or install to profile:
+nix profile install github:dexoron/dcr
+```
+
+## Cargo (crates.io)
+
+```sh
+cargo install dcr
+```
+
+## Linux / macOS (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+```
+
+## BSD (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install_bsd.sh | sh
+```
+
+## Windows (PowerShell)
+
+```powershell
+irm https://dcr.dexoron.su/install.ps1 | iex
+```
+
+## From source
+
+```sh
+git clone https://github.com/dexoron/dcr.git
+cd dcr && cargo build --release
+ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
+```
+
+## Post-install
+
+Verify the installation:
+
+```bash
+dcr --version
+```
+
+Man pages are available after installation:
+
+```bash
+man dcr
+man dcr-build
+```
+
+To use the registry, create `~/.dcr/config.toml`:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```

docs/getting-started/project-structure.md

@@ -1,40 +0,0 @@
-# Project structure
-
-## Minimal project
-
-```text
-project/
-- dcr.toml
-- src/
-- - main.c
-```
-
-## Typical generated/optional files
-
-```text
-project/
-- dcr.toml
-- dcr.lock
-- src/
-- - ... source files ...
-- target/
-- - debug/
-- - - obj/
-- - - deps/
-- - release/
-- - - obj/
-- - - deps/
-```
-
-## Meaning
-
-- `dcr.toml`: main project configuration.
-- `dcr.lock`: generated lock file for resolved path dependencies.
-- `src/`: recursively scanned source directory.
-- `target/<target>/<profile>/obj/`: cached object files for incremental rebuild (where `<target>` is `native` or target triple).
-- `target/<target>/<profile>/deps/`: synchronized copies of path dependencies.
-- `target/<target>/<profile>/<name>` (or `.exe` on Windows): output for `kind = "bin"`.
-- `target/<target>/<profile>/lib<name>.a` (or `<name>.lib` on Windows): output for `kind = "staticlib"`.
-- `target/<target>/<profile>/lib<name>.so` (or `.dylib` on macOS, `<name>.dll` on Windows): output for `kind = "sharedlib"`.
-
-If `build.out_dir` is set, the final artifact is written to that custom directory, while object cache still stays in `target/<target>/<profile>/obj`.

docs/ide-integration.mdx

@@ -0,0 +1,51 @@
+---
+sidebar_label: IDE Integration
+---
+
+# IDE Integration
+
+## VS Code
+
+```bash
+dcr gen vscode
+```
+
+Generates in `.vscode/`:
+
+| File | Purpose |
+|------|---------|
+| `tasks.json` | `build` task (dcr build) |
+| `launch.json` | Debug launch configuration |
+| `settings.json` | clangd/IntelliSense: include paths, standard |
+| `extensions.json` | Recommends vscode-clangd, vscode-lldb |
+
+## CLion
+
+```bash
+dcr gen clion
+```
+
+Generates in `.idea/`:
+
+| File | Purpose |
+|------|---------|
+| `externalTools.xml` | Build, Run, Clean, Test as external tools |
+| `customTargets.xml` | Custom build targets |
+| `misc.xml` | C/C++ project settings |
+| `runConfigurations/<name>.xml` | Per-binary run configurations |
+
+## compile_commands.json
+
+```bash
+dcr gen compile-commands
+```
+
+Generates `compile_commands.json` at project root. Standard format for clangd, C/C++ IntelliSense, static analyzers.
+
+## project-info
+
+```bash
+dcr gen project-info
+```
+
+Outputs JSON array with project metadata (see [gen-commands](/docs/commands/gen-commands)).

docs/license.mdx

@@ -0,0 +1,46 @@
+---
+sidebar_label: License
+---
+
+# License
+
+## DCR
+
+DCR itself is [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html) licensed.
+
+> **Note:** DCR is a build tool, not a library. The GPL applies only to DCR's own source code. Projects built with DCR are not subject to DCR's license — their licensing is determined solely by their own code and dependencies.
+
+## Vendored libraries
+
+DCR statically links the following C libraries through its vendored Rust dependencies:
+
+| Library | License | Bundled by |
+|---|---|---|
+| [libgit2](https://libgit2.org) | MIT OR Apache-2.0 | `git2` / `libgit2-sys` |
+| [libssh2](https://libssh2.org) | MIT OR Apache-2.0 | `libgit2-sys` |
+| [zlib](https://zlib.net) | MIT OR Apache-2.0 | `libgit2-sys` |
+| [OpenSSL](https://openssl.org) | Apache-2.0 | `openssl-sys` / `openssl-src` |
+| [ring](https://github.com/briansmith/ring) | Apache-2.0 AND ISC | `rustls` |
+
+## Rust dependencies
+
+DCR is written in Rust. The following notable Rust crates are statically linked:
+
+| Crate | License |
+|---|---|
+| [`reqwest`](https://crates.io/crates/reqwest) | MIT OR Apache-2.0 |
+| [`rustls`](https://crates.io/crates/rustls) | Apache-2.0 OR ISC OR MIT |
+| [`serde`](https://crates.io/crates/serde) | MIT OR Apache-2.0 |
+| [`toml`](https://crates.io/crates/toml) | MIT OR Apache-2.0 |
+| [`sha2`](https://crates.io/crates/sha2) | MIT OR Apache-2.0 |
+| [`git2`](https://crates.io/crates/git2) | MIT OR Apache-2.0 |
+| [`openssl`](https://crates.io/crates/openssl) | Apache-2.0 |
+| [`tokio`](https://crates.io/crates/tokio) | MIT |
+| [`hyper`](https://crates.io/crates/hyper) | MIT |
+| [`ctrlc`](https://crates.io/crates/ctrlc) | MIT OR Apache-2.0 |
+
+Full dependency tree (143 packages) is available in [`Cargo.lock`](https://github.com/dexoron/dcr/blob/main/Cargo.lock). The overwhelming majority are dual-licensed under MIT OR Apache-2.0.
+
+## Additional credits
+
+- DCR's CLI design and project model are inspired by [Cargo](https://doc.rust-lang.org/cargo/).

docs/recipes/cross-to-windows.mdx

@@ -0,0 +1,49 @@
+---
+sidebar_label: Cross-compile to Windows
+---
+
+# Cross-Compile to Windows from Linux
+
+Building a Windows binary on Linux using mingw-w64.
+
+## Install toolchain
+
+```bash
+# Ubuntu/Debian
+sudo apt install mingw-w64
+
+# Fedora
+sudo dnf install mingw64-gcc mingw64-binutils
+```
+
+## Configuration
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+compiler = "clang"
+kind = "bin"
+target = "x86_64-pc-windows-gnu"    # explicit mingw, not msvc
+```
+
+## Build
+
+```bash
+dcr build --target x86_64-pc-windows-gnu --release
+```
+
+Artifact: `target/x86_64-pc-windows-gnu/release/my-app.exe`.
+
+## Custom toolchain
+
+```toml
+[toolchain]
+cc = "x86_64-w64-mingw32-gcc"
+cxx = "x86_64-w64-mingw32-g++"
+```

docs/recipes/library-project.mdx

@@ -0,0 +1,65 @@
+---
+sidebar_label: Library project
+---
+
+# Library Project
+
+Creating a static library and using it in another project.
+
+## Step 1: Create the library
+
+```bash
+dcr new my-lib
+cd my-lib
+```
+
+`dcr.toml`:
+```toml
+[package]
+name = "my-lib"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+kind = "staticlib"
+```
+
+`src/my_lib.h`:
+```c
+#ifndef MY_LIB_H
+#define MY_LIB_H
+int add(int a, int b);
+#endif
+```
+
+`src/my_lib.c`:
+```c
+#include "my_lib.h"
+int add(int a, int b) { return a + b; }
+```
+
+## Step 2: Build
+
+```bash
+dcr build --release
+```
+
+Artifacts:
+- `target/<triple>/release/libmy-lib.a` (Linux)
+- `target/release/my-lib.lib` (Windows)
+- `target/include/` — header files
+
+## Step 3: Use in another project
+
+```bash
+dcr new my-app
+cd my-app
+dcr add my-lib ../my-lib
+```
+
+Automatically:
+- Adds include path to `target/include/` of the library
+- Adds lib path to `target/<triple>/release/`
+- Links `libmy-lib.a` / `my-lib.lib`

docs/recipes/multi-package-workspace.mdx

@@ -0,0 +1,98 @@
+---
+sidebar_label: Multi-package workspace
+---
+
+# Multi-Package Workspace
+
+A project with three packages: two libraries and a binary.
+
+## Structure
+
+```
+workspace/
+├── dcr.toml              # root workspace
+├── lib-core/
+│   ├── dcr.toml
+│   └── src/core.c
+├── lib-utils/
+│   ├── dcr.toml
+│   └── src/utils.c
+└── app/
+    ├── dcr.toml
+    └── src/main.c
+```
+
+## Root dcr.toml
+
+```toml
+[package]
+name = "my-workspace"
+version = "0.1.0"
+type = "none"
+
+[build]
+inherit = true
+language = "c"
+standard = "c11"
+
+[workspace.lib-core]
+path = "lib-core"
+
+[workspace.lib-utils]
+path = "lib-utils"
+deps = ["lib-core"]
+
+[workspace.app]
+path = "app"
+deps = ["lib-core", "lib-utils"]
+main = true
+```
+
+## Packages
+
+`lib-core/dcr.toml`:
+```toml
+[package]
+name = "lib-core"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "staticlib"
+```
+
+`lib-utils/dcr.toml`:
+```toml
+[package]
+name = "lib-utils"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "staticlib"
+```
+
+`app/dcr.toml`:
+```toml
+[package]
+name = "app"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "bin"
+```
+
+## Build
+
+```bash
+cd workspace
+dcr build                     # builds everything in correct order
+dcr build --workspace app     # only app (lib-core and lib-utils built as deps)
+dcr run                       # builds and runs main package
+```
+
+Build order (topological sort):
+1. `lib-core`
+2. `lib-utils` (depends on lib-core)
+3. `app` (depends on lib-core, lib-utils)

docs/reference-and-help/cli-reference.md

@@ -1,38 +0,0 @@
-# CLI reference
-
-## Command list
-
-```text
-dcr new <name>
-dcr init
-dcr setup
-dcr add <name> <source>(optional)
-dcr build [--debug|--release] [--target <triple>]
-dcr run [--debug|--release]
-dcr clean [--debug|--release] [--all]
-dcr tree
-dcr test
-dcr gen <subcommand>
-dcr fmt
-dcr setup
-dcr --help
-dcr --version
-dcr --update
-```
-
-## Notes on argument parsing
-
-- `build`/`run` parse flags in any order (`--debug|--release`, `--force`, `--clean`, `--verbose`, `--workspace`) and reject duplicates.
-- `new` requires exactly one argument.
-- `init` and `--update` do not accept extra arguments.
-- `clean` accepts `--debug|--release` and optional `--all`.
-- `gen` supports `project-info`, `compile-commands`, `vscode`, `clion`.
-- `fmt` formats C/C++ sources (`.c`, `.cpp`, `.cxx`, `.cc`, `.h`, `.hpp`, `.hxx`, `.hh`) in `src/` and `tests/` using `clang-format`.
-- `setup` initializes DCR registries and local configuration.
-- `tree` shows a dependency tree (similar to `cargo tree`).
-- `test` / `tests` runs the project's tests.
-
-## Exit behavior overview
-
-- Successful command execution returns `0`.
-- Validation/build/runtime failures return non-zero status.

docs/reference-and-help/config-reference.md

@@ -1,151 +0,0 @@
-# Config reference
-
-## Full schema
-
-```toml
-[package]
-name        = "string"            # required
-version     = "string"            # required
-type        = "string"            # optional: "app", "lib", "none"
-description = "string"            # optional
-author      = "string"            # optional
-authors     = ["string", "..."]   # optional
-license     = "string"            # optional
-homepage    = "string"            # optional
-repository  = "string"            # optional
-readme      = "string"            # optional
-keywords    = ["string", "..."]   # optional
-categories  = ["string", "..."]   # optional
-
-[build]
-language     = "c|c++|cpp|cxx|asm"               # required (string or array)
-standard     = "string"                          # optional (default "c11")
-cxx_standard = "string"                          # optional (e.g. "c++17", "gnu++17")
-compiler     = "string"                          # required (e.g. "clang", "gcc")
-kind         = "bin|staticlib|sharedlib|efi|elf|none|custom" # optional (default "bin")
-target       = "string"                          # optional (cross-compilation target triple)
-out_dir      = "string"                          # optional (custom output directory)
-platform     = "string"                          # optional (architecture hint, -march)
-
-cflags       = ["string", "..."]                 # optional (supports {version} etc.)
-ldflags      = ["string", "..."]                 # optional (supports {version} etc.)
-ldscript     = "string"                          # optional (linker script path)
-exclude      = ["string", "..."]                 # optional (glob patterns)
-include      = ["string", "..."]                 # optional (allowlist + -I dirs)
-roots        = ["string", "..."]                 # optional (source roots)
-src_disable  = false                             # optional (disable default src/)
-pkg_config   = ["string", "..."]                 # optional (pkg-config packages)
-generated    = ["string", "..."]                 # optional (generated file patterns)
-expect       = ["string", "..."]                 # optional (expected artifact patterns)
-clean        = ["string", "..."]                 # optional (extra clean paths)
-targets      = ["string", "..."]                 # optional (build targets)
-filename     = "string"                          # optional (custom output name)
-extension    = "string"                          # optional (custom extension)
-inherit      = true                              # optional (inherit base settings)
-
-[[build.steps]]
-name = "string"    # required
-in   = "glob"      # required
-out  = "path"      # required
-cmd  = "string"    # required
-
-# Inline steps (equivalent to [[build.steps]])
-steps = [
-  { name = "string", in = "glob", out = "path", cmd = "string" },
-]
-
-[[build.post_steps]]
-name = "string"    # required
-in   = "glob"      # required (or "target/...")
-out  = "path"      # required
-cmd  = "string"    # required
-
-# Inline post_steps (equivalent to [[build.post_steps]])
-post_steps = [
-  { name = "string", in = "glob", out = "path", cmd = "string" },
-]
-
-# Profile overrides (inherit all from [build])
-[build.debug]
-cflags  = ["string", "..."]  # optional
-ldflags = ["string", "..."]  # optional
-
-[build.release]
-cflags  = ["string", "..."]  # optional
-ldflags = ["string", "..."]  # optional
-
-# Target-specific overrides
-[build.linux]
-compiler = "string"
-cflags   = ["string", "..."]
-
-[build.windows]
-compiler = "string"
-
-# Target + profile override
-[build.linux.release]
-cflags = ["string", "..."]
-
-[toolchain]
-cc  = "string"  # optional (C compiler override)
-cxx = "string"  # optional (C++ compiler override)
-as  = "string"  # optional (assembler override)
-ar  = "string"  # optional (archiver override)
-ld  = "string"  # optional (linker override)
-uic = "string"  # optional (Qt uic)
-moc = "string"  # optional (Qt moc)
-rcc = "string"  # optional (Qt rcc)
-
-[run]
-cmd = "string"  # required for `dcr run`
-
-# Debug run variant
-[run.debug]
-cmd = "string"
-
-[workspace]
-[workspace.member_name]
-path = "string"             # required
-deps = ["string", "..."]    # optional
-
-[dependencies]
-[dependencies.dep_name]
-path    = "string"          # local path
-# or
-version = "string"          # registry version
-# or
-git     = "string"          # git URL
-branch  = "string"          # optional (git branch)
-tag     = "string"          # optional (git tag)
-rev     = "string"          # optional (git commit)
-# common fields:
-include = ["string", "..."] # optional (include dirs)
-lib     = ["string", "..."] # optional (lib dirs)
-libs    = ["string", "..."] # optional (link libs)
-features        = ["string", "..."] # optional (registry features)
-default-features = true             # optional (include default features)
-```
-
-## Validation rules
-
-- `[package]`, `[build]`, `[dependencies]` must exist.
-- Required string fields must be non-empty.
-- `build.kind` must be `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, or `custom`.
-- Dependency fields `include/lib/libs` must be string arrays when provided.
-- `build.exclude`/`build.include` must be string arrays when provided.
-- `build.roots` must be a string array when provided.
-- `build.src_disable` must be boolean when provided.
-- `build.clean`/`build.generated`/`build.pkg_config`/`build.expect` must be string arrays when provided.
-- `build.debug`/`build.release` must be tables; their `cflags`/`ldflags` must be string arrays.
-- `build.steps`/`build.post_steps` entries must include `name`, `in`, `out`, `cmd`.
-- `build.language` may be a string or array (for example `["c", "c++", "asm"]`).
-- `[build.<profile>]` tables inherit all base values and override any fields they specify.
-  Array fields (like `cflags`/`ldflags`) are appended to the base array.
-
-## Generated defaults (`dcr new` / `dcr init`)
-
-- `package.version = "0.1.0"`
-- `build.language = "c"`
-- `build.standard = "c11"`
-- `build.compiler = "clang"`
-- `build.kind = "bin"`

docs/reference-and-help/contributing-and-bug-reports.md

@@ -1,34 +0,0 @@
-# Contributing & Bug reports
-
-## Contribution workflow
-
-1. Fork `dexoron/dcr` (and `dexoron/dcr-site` if docs website changes are needed).
-2. Make focused changes.
-3. Run checks locally:
-
-```bash
-cargo fmt --all
-cargo clippy --all-targets --all-features -- -D warnings
-cargo check
-```
-
-4. Open a PR with short rationale and behavior impact.
-5. Update docs when CLI behavior changes.
-
-## Bug report checklist
-
-Include:
-
-1. DCR version (`dcr --version`).
-2. OS and compiler/toolchain version.
-3. Reproduction steps.
-4. Expected result.
-5. Actual result and full error output.
-6. Minimal reproducible project.
-
-## Where to report
-
-Use GitHub Issues in the relevant repository:
-
-- <https://github.com/dexoron/dcr>
-- <https://github.com/dexoron/dcr-site>

docs/reference-and-help/faq.md

@@ -1,35 +0,0 @@
-# FAQ
-
-## What commands are available?
-
-`new`, `init`, `add`, `build`, `run`, `clean`, `test`, `fmt`, `tree`, `gen`, `setup`, `--help`, `--version`, `--update`.
-
-## Is `dcr.toml` mandatory?
-
-Yes, for `build`, `run`, and `clean`.
-
-## What source files are compiled?
-
-DCR scans `src/` recursively:
-
-- for C: `*.c`
-- for C++: `*.cpp`, `*.cxx`, `*.cc`
-
-## Can I switch compiler?
-
-Yes. Set `build.compiler` in `dcr.toml` (for example `gcc`, `clang`, `cl`, `clang-cl`).
-
-## How does incremental rebuild work?
-
-It compares source file mtime with object file mtime.
-Header dependencies are tracked too: if an included header changes (or disappears), rebuild is triggered.
-
-## What does `dcr run` do if build fails?
-
-It tries to run an existing binary from the selected profile; if none exists, it reports an error.
-
-## How do I update DCR?
-
-Use `dcr --update` for non-package-managed installs.
-
-If installed through pacman/AUR, update via package manager.

docs/reference-and-help/flags-and-environment.md

@@ -1,51 +0,0 @@
-# Flags & environment
-
-This page summarizes runtime flags and environment variables that affect DCR behavior.
-
-## Build/run flags
-
-Used with `dcr build` and `dcr run`:
-
-- `--debug`: select debug profile.
-- `--release`: select release profile.
-- `--target <triple>`: build for specified target (short names: `linux`, `macos`, `windows`, `freebsd`, `openbsd`, `netbsd`).
-- `--force`: ignore incremental cache checks and rebuild.
-- `--clean`: remove `target/<profile>` and `build.clean` paths before build.
-- `--verbose`: print compiler/linker command lines to stderr.
-- `--workspace <name>`: filter build to a specific workspace member.
-
-Notes:
-
-- Flags can be passed in any order.
-- Duplicate profile flags are rejected.
-
-## Clean flags
-
-Used with `dcr clean`:
-
-- `--debug` / `--release`: clean only selected profile directory.
-- `--all`: in workspace root, also clean all members.
-
-## Environment variables
-
-Tool selection overrides:
-
-- `DCR_COMPILER` (all languages)
-- `DCR_CC`, `DCR_CXX`, `DCR_AS`, `DCR_AR`, `DCR_LD`
-
-Diagnostics:
-
-- `DCR_DEBUG=1` enables verbose build logging.
-
-## Quick examples
-
-```sh
-# Force full release rebuild
-dcr build --release --force
-
-# Clean before debug run
-dcr run --clean --debug
-
-# Use custom compiler from env
-DCR_CC=clang-18 dcr build --debug
-```

docs/reference-and-help/troubleshooting-map.md

@@ -1,75 +0,0 @@
-# Troubleshooting map
-
-Fast mapping from symptom to likely cause and first action.
-
-## `dcr.toml file not found`
-
-Likely cause:
-- you are outside project root (or member root).
-
-First action:
-```sh
-pwd
-ls
-```
-Run DCR from directory that contains `dcr.toml`.
-
-## `Invalid config: missing [package]` / `missing [build]`
-
-Likely cause:
-- incomplete config in root project.
-
-First action:
-- ensure root `dcr.toml` includes `[package]`, `[build]`, and `[dependencies]`.
-- for workspace setups, keep these sections in root and add `[workspace]` additionally.
-
-## `Unknown build flag` or profile-flag errors
-
-Likely cause:
-- typo in flag or duplicate profile flag.
-
-First action:
-```sh
-dcr --help
-```
-Use only supported flags and at most one of `--debug` / `--release`.
-
-## Dependency include/lib path errors
-
-Likely cause:
-- path in `[dependencies]` does not exist.
-
-First action:
-- verify `path`, `include`, `lib` values.
-- if using profile placeholders, confirm expanded paths exist for selected profile.
-
-## `Cannot run library build`
-
-Likely cause:
-- `build.kind` is `staticlib` or `sharedlib`.
-
-First action:
-- switch `build.kind` to `bin`, or set `[run].cmd` if you intentionally need custom run command.
-
-## Build succeeds but output is stale
-
-Likely cause:
-- stale artifacts or generated files from previous runs.
-
-First action:
-```sh
-dcr clean --all
-dcr build --force
-```
-
-## `dcr --update` suggests package manager update
-
-Likely cause:
-- DCR binary is managed by pacman/AUR.
-
-First action:
-```sh
-yay -Syu dcr
-# or
-paru -Syu dcr
-```

docs/reference-and-help/workspace-guide.md

@@ -1,53 +0,0 @@
-# Workspace guide
-
-`[workspace]` lets you build related DCR projects in dependency order from one root.
-
-## Important rule
-
-Workspace root still needs a valid root project config:
-
-- `[package]`
-- `[build]`
-- `[dependencies]`
-
-`[workspace]` augments that root config; it does not replace required root sections.
-
-## Minimal example
-
-```toml
-[package]
-name = "root-app"
-version = "0.1.0"
-
-[build]
-language = "c"
-standard = "c11"
-compiler = "clang"
-kind = "bin"
-
-[dependencies]
-
-[workspace]
-core = { path = "./modules/core", deps = [] }
-net = { path = "./modules/net", deps = ["core"] }
-app = { path = "./modules/app", deps = ["core", "net"] }
-```
-
-Each member path must point to a directory containing its own `dcr.toml`.
-
-## Build behavior
-
-- Running `dcr build` in workspace root builds members in topological dependency order, then builds the root project.
-
-- Running `dcr clean --all` in workspace root cleans all members too.
-
-- `dcr gen` in workspace root includes root + members in generated outputs.
-
-## Common errors
-
-- `workspace.<name>.path does not contain dcr.toml`:
-  member path is wrong or config is missing.
-- `workspace dependency '<name>' not found`:
-  `deps` references unknown member.
-- `workspace dependency cycle at <name>`:
-  cyclic dependencies in member graph.

docs/reference/build-profiles.mdx

@@ -0,0 +1,55 @@
+---
+sidebar_label: Build profiles
+---
+
+# Build Profiles
+
+Profiles allow overriding `[build]` fields for specific build modes.
+
+## Configuration
+
+```toml
+[build]
+language = "c"
+standard = "c17"
+cflags = ["-Wall"]
+
+[build.debug]
+cflags = ["-O0", "-g"]
+
+[build.release]
+cflags = ["-O3", "-DNDEBUG"]
+```
+
+## Merge rules
+
+Fields from `[build.<profile>]` are merged on top of `[build]`:
+
+- **Scalar fields** (strings, numbers, bools) — replaced
+- **Arrays** (`cflags`, `ldflags`, ...) — **appended** (extend the `[build]` array)
+
+Set `inherit = false` to disable array inheritance (only profile's own arrays are used).
+
+## Built-in profiles
+
+| Profile | Default cflags |
+|---------|---------------|
+| `debug` | `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG` |
+| `release` | `-O3 -DNDEBUG` |
+
+## Target-specific profiles
+
+```toml
+[build.linux]
+cflags = ["-DLINUX"]
+
+[build.windows.debug]
+cflags = ["-DWIN32", "-O0", "-g"]
+```
+
+Application order (highest priority first):
+1. `[build.<target>.<profile>]`
+2. `[build.<profile>.<target>]`
+3. `[build.<target>]`
+4. `[build.<profile>]`
+5. `[build]`

docs/reference/build-system.mdx

@@ -0,0 +1,101 @@
+---
+sidebar_label: Build system
+---
+
+# Build System
+
+## Compiler Backends
+
+DCR supports 4 compilation backends. Selection is automatic based on file extension.
+
+| Backend | Files | When used |
+|---------|-------|-----------|
+| `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.S` | gcc/clang on Linux/macOS/BSD |
+| `msvc` | `.c`, `.cpp`, `.cxx`, `.cc` | Windows (cl, clang-cl) |
+| `gas` | `.s` | ARM/ARM64 assembler (no preprocessor) |
+| `nasm` | `.asm` | x86/x86_64 assembler |
+
+### Unix CC
+
+- Compiler resolved via `resolve_compiler()`: `DCR_COMPILER` > `DCR_CC` > `[toolchain]` > `build.compiler` > `PATH`
+- Supports `.d` files for header dependency tracking
+- Flags: `-std=`, `-MMD -MF`, `-c -o`, `-I`, `-L`, `-l`
+
+### MSVC
+
+- Supports cl.exe and clang-cl.exe
+- Flags: `/std:`, `/Fo:`, `/Fe:`, `/I`, `/link`
+
+### GAS / NASM
+
+- GAS: `-I`, `-c -o`, `--defsym`
+- NASM: `-I`, `-o`, `-D`, `-f` (format: win64/elf64/macho64/macho32/elf32)
+
+## Incremental Builds
+
+Three levels of incrementality:
+
+1. **mtime** — if output is newer than all inputs, skip
+2. **`.d` files** — header change tracking (including transitive)
+3. **SHA256 fingerprint** — recompile if compiler flags changed (stored in `.dcr_fingerprint`)
+
+## Parallel Compilation
+
+- `thread::scope` for thread pool
+- Atomic task queue (`AtomicU64`)
+- Mutex on stdout (`OUTPUT_MUTEX`)
+- Thread count = `available_parallelism()`
+
+## Build Kinds
+
+| Kind | Type | Path (Linux example) |
+|------|------|---------------------|
+| `bin` | Executable | `target/<triple>/<profile>/<name>` (.exe on Windows) |
+| `staticlib` | Static library | `target/<triple>/<profile>/lib<name>.a` (.lib) |
+| `sharedlib` | Dynamic library | `target/<triple>/<profile>/lib<name>.so` (.dll/.dylib) |
+| `efi` | UEFI application | `target/<triple>/<profile>/<name>.efi` |
+| `elf` | ELF without stdlib | `target/<triple>/<profile>/<name>` |
+| `none` | Compile only, no link | — |
+| `custom` | Full filename+extension control | `target/<triple>/<profile>/<filename>.<extension>` |
+
+## Build Steps
+
+DCR supports pre-build and post-build steps:
+
+- `build.steps` — commands before compilation
+- `build.post_steps` — commands after compilation
+
+Substitutions: `{stem}`, `{in}`, `{out}`, `{profile}`, `{version}`, `{name}`.
+
+Example Qt codegen via build steps:
+
+```toml
+[build.steps]
+moc = "moc {in} -o {out}"
+```
+
+## pkg-config
+
+Automatic lookup (read from raw config):
+
+```toml
+[build]
+pkg_config = ["sdl2", "gl"]
+```
+
+DCR runs `pkg-config --cflags sdl2 gl` and `pkg-config --libs sdl2 gl` and adds results to compiler/linker flags.
+
+## Variable Substitution
+
+Supported variables:
+
+| Variable | Description |
+|----------|-------------|
+| `{version}` | Package version |
+| `{version_major}` | Major version part |
+| `{version_minor}` | Minor version part |
+| `{version_patch}` | Patch version |
+| `{version_suffix}` | Suffix (e.g., `-rc1`) |
+| `{version_suffix_dash}` | Suffix with dash |
+| `{profile}` | Profile name (debug/release) |
+| `{name}` | Package name |

docs/reference/cross-compilation.mdx

@@ -0,0 +1,60 @@
+---
+sidebar_label: Cross-compilation
+---
+
+# Cross-Compilation
+
+## Short Names
+
+DCR supports short platform names:
+
+| Short Name | Full Triple |
+|-----------|-------------|
+| `linux` | `x86_64-unknown-linux-gnu` |
+| `macos` | `x86_64-apple-darwin` |
+| `windows` | `x86_64-pc-windows-msvc` |
+
+```bash
+dcr build --target windows
+```
+
+## Full Triples
+
+```bash
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --target x86_64-pc-windows-gnu      # mingw
+dcr build --target armv7-unknown-linux-gnueabihf
+```
+
+## clang --target
+
+When using clang, DCR injects `--target=<triple>` into CFLAGS.
+
+```toml
+[build]
+compiler = "clang"
+target = "aarch64-unknown-linux-gnu"
+# Auto: cflags += ["--target=aarch64-unknown-linux-gnu"]
+```
+
+## Bare-Metal
+
+For targets containing `none`, `-elf`, `eabi`, or `baremetal`, DCR default flags are disabled (no system include paths, no `-l` libc).
+
+```bash
+dcr build --target aarch64-none-elf
+```
+
+## Target Directory
+
+On Linux with explicit target:
+
+```
+target/<triple>/<profile>/
+```
+
+On macOS/Windows or without target:
+
+```
+target/<profile>/
+```

docs/reference/dcr-toml.mdx

@@ -0,0 +1,132 @@
+---
+sidebar_label: dcr.toml overview
+---
+
+# dcr.toml
+
+Main project configuration file. Located at the project root.
+
+## Structure
+
+```toml
+[package]
+# required fields
+
+[build]
+# build settings
+
+[build.debug]       # optional: debug override
+[build.release]     # optional: release override
+
+[build.linux]       # optional: Linux override
+[build.windows]     # optional: Windows override
+[build.windows.debug]  # target + profile combination
+
+[toolchain]
+# compiler/linker paths
+
+[dependencies]
+# project dependencies
+
+[workspace]
+# multi-package configuration
+
+[run]
+# run settings
+```
+
+## [package]
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | yes | Project name |
+| `version` | yes | Semantic version |
+| `type` | yes | `app`, `lib`, `none` |
+| `license` | no | SPDX license identifier |
+| `author` | no | Author |
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "app"
+license = "MIT"
+author = "John Doe"
+```
+
+## [build]
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `language` | `"c"` | `"c"`, `"c++"`, `"cpp"`, `"cxx"`, `"asm"` |
+| `standard` | `"c11"` | C standard (`c11`, `c17`, `c23`) |
+| `cxx_standard` | `"c++20"` | C++ standard (`c++17`, `c++20`, `c++23`) |
+| `compiler` | `"clang"` | Preferred compiler |
+| `kind` | `"bin"` | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom` |
+| `target` | host | Target triple for cross-compilation |
+| `platform` | `"native"` | `native`, `efi`, `freestanding` |
+| `cflags` | `[]` | Additional C/C++/ASM flags |
+| `ldflags` | `[]` | Additional linker flags |
+| `filename` | `""` | Custom output file name |
+| `extension` | `""` | Custom file extension |
+| `roots` | `["src"]` | Source root directories |
+| `exclude` | `[]` | Exclude patterns |
+| `include` | `[]` | Additional include directories |
+| `src_disable` | `false` | Disable auto source discovery |
+| `inherit` | `false` | Inherit build from workspace root |
+| `clean` | `[]` | Glob patterns for custom clean paths |
+| `out_dir` | `""` | Custom output directory |
+| `workspace_only` | `false` | Workspace-only, not built standalone |
+
+Settings from raw config (not in typed struct):
+- `pkg_config` — list of pkg-config packages
+- `ldscript` — linker script path
+- `build.steps` / `build.post_steps` — codegen steps
+
+Example:
+
+```toml
+[build]
+language = "c++"
+standard = "c23"
+cxx_standard = "c++23"
+compiler = "clang"
+kind = "sharedlib"
+cflags = ["-Wall", "-Wextra"]
+```
+
+## [toolchain]
+
+```toml
+[toolchain]
+cc = "/usr/bin/clang"
+cxx = "/usr/bin/clang++"
+as = "/usr/bin/as"
+ar = "/usr/bin/ar"
+ld = "/usr/bin/ld.lld"
+```
+
+Raw config also supports `uic`, `moc`, `rcc` for Qt codegen.
+
+## [dependencies]
+
+See [dependencies](/docs/reference/dependencies).
+
+## [run]
+
+```toml
+[run]
+cmd = "./target/{profile}/{name}"
+```
+
+Substitutions:
+- `{version}` — package version
+- `{version_major}`, `{version_minor}`, `{version_patch}`, `{version_suffix}`, `{version_suffix_dash}` — version parts
+- `{profile}` — debug / release
+- `{name}` — package name
+
+Default `cmd` = `./target/{profile}/{name}` (macOS/Windows) or `./target/<triple>/<profile>/<name>` (Linux).
+
+## [workspace]
+
+See [workspaces](/docs/reference/workspaces).

docs/reference/dependencies.mdx

@@ -0,0 +1,84 @@
+---
+sidebar_label: Dependencies
+---
+
+# Dependencies
+
+## Formats
+
+The `[dependencies]` section supports three formats:
+
+### String (registry)
+
+```toml
+[dependencies]
+fmt = "10.1.1"
+spdlog = "1.12"
+catch2 = "3.4.0"
+```
+
+The version string is used as-is for registry lookup.
+
+### Table (git)
+
+```toml
+[dependencies]
+fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+```
+
+Fields: `git`, `branch`, `tag`, `rev`.
+
+### Table (path)
+
+```toml
+[dependencies]
+mylib = { path = "../mylib" }
+```
+
+## Registry
+
+DCR uses a package registry for dependency lookup by name.
+
+```toml
+# ~/.dcr/config.toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+Registry priority: order in `config.toml`. The `DCR_INDEX_PATH` variable overrides the path to `index.json`.
+
+## Git dependencies
+
+DCR clones git repositories via `git2`:
+
+- `branch` — switch to a branch
+- `tag` — switch to a tag
+- `rev` — switch to a specific commit
+- `features` — feature flags (parsed, but does not affect build)
+
+Cache path: `~/.dcr/git/<hash>/`.
+
+## Path dependencies
+
+Local paths. DCR automatically discovers include and lib directories from the neighbor's `dcr.toml`.
+
+```toml
+[dependencies]
+mylib = { path = "/abs/path/to/lib" }
+mylib = { path = "../relative/path" }
+```
+
+## dcr.lock
+
+Dependency lock file. Contains package names and sources.
+
+Created during `dcr build` when registry dependencies are present. Not updated during `dcr add` — only on the next `dcr build`.
+
+## Resolution process
+
+1. Load all dependencies (registry → git → path)
+2. For path deps: recursively read their `dcr.toml`
+3. For registry deps: search `index.json`
+4. For git deps: clone to cache
+5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler

docs/reference/environment-variables.mdx

@@ -0,0 +1,59 @@
+---
+sidebar_label: Environment variables
+---
+
+# Environment Variables
+
+## DCR_COMPILER
+
+Overrides the compiler for all languages. **Highest priority.**
+
+```bash
+export DCR_COMPILER=clang
+dcr build
+```
+
+Compiler resolution priority:
+1. `DCR_COMPILER` (env)
+2. `DCR_CC` / `DCR_CXX` / `DCR_AS` (env)
+3. `[toolchain]` (dcr.toml)
+4. `build.compiler` (dcr.toml)
+5. `PATH`
+
+## DCR_CC / DCR_CXX / DCR_AS
+
+Per-language override (lower priority than `DCR_COMPILER`, higher than `[toolchain]`).
+
+```bash
+export DCR_CC=gcc-14
+export DCR_CXX=g++-14
+export DCR_AS=arm-linux-gnueabihf-as
+```
+
+## DCR_LD / DCR_AR
+
+Override linker and archiver.
+
+```bash
+export DCR_LD=ld.lld
+export DCR_AR=llvm-ar
+```
+
+## DCR_DEBUG
+
+Enables debug mode — prints all compilation commands to stderr before execution.
+
+```bash
+export DCR_DEBUG=1
+dcr build
+```
+
+## DCR_INDEX_PATH
+
+Overrides the path to the registry `index.json`.
+
+```bash
+export DCR_INDEX_PATH=/custom/path/index.json
+```
+
+Default: `~/.dcr/index.json`.

docs/reference/platform-support.mdx

@@ -0,0 +1,51 @@
+---
+sidebar_label: Platform support
+---
+
+# Platform Support
+
+## Target Triples
+
+DCR normalizes target triples. Short platform names are expanded to full triples.
+
+### Linux
+
+```
+target/<arch>-unknown-linux-gnu/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64` (host-detected).
+
+Artifact type: ELF. Extensions: `.so` (sharedlib), `.a` (staticlib).
+
+### macOS
+
+```
+target/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64` (host-detected).
+
+Extensions: `.dylib` (sharedlib), `.a` (staticlib).
+
+### Windows
+
+```
+target/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64`.
+
+Extensions: `.exe` (bin), `.lib` (staticlib), `.dll` (sharedlib), `.efi` (UEFI).
+
+### BSD
+
+```
+target/<arch>-unknown-<os>/<profile>/
+```
+
+Supported systems: `freebsd`, `openbsd`, `netbsd`, `dragonfly`.
+
+## Host Detection
+
+DCR uses `std::env::consts::ARCH` and `std::env::consts::OS` for host platform detection. Used as fallback when `target` is not specified.

docs/reference/workspaces.mdx

@@ -0,0 +1,67 @@
+---
+sidebar_label: Workspaces
+---
+
+# Workspaces
+
+Workspaces allow managing multiple packages in a single repository.
+
+## Configuration
+
+```toml
+[workspace.lib-core]
+path = "lib-core"
+
+[workspace.lib-utils]
+path = "lib-utils"
+deps = ["lib-core"]
+
+[workspace.app]
+path = "app"
+deps = ["lib-core", "lib-utils"]
+main = true
+```
+
+### Member fields
+
+| Field | Description |
+|-------|-------------|
+| `path` | Path to the package (relative to workspace root) |
+| `deps` | Dependencies on other members |
+| `main` | Mark as the main package |
+
+## Topological sort
+
+DCR automatically sorts packages by dependencies: package A is built before B if B depends on A.
+
+Cyclic dependencies are detected and cause an error.
+
+## Build
+
+```bash
+dcr build                    # build all packages in dependency order
+dcr build --workspace app    # build only app (dependencies built automatically)
+```
+
+When building a workspace, member outputs (libraries) are automatically added to include/lib paths of dependent packages.
+
+## Clean
+
+```bash
+dcr clean                    # clean only root target/
+dcr clean --all              # clean target/ of all packages
+```
+
+## Inheritance
+
+If a member has `inherit = true` in its `[build]` section, fields from the root `[build]` are merged into the member:
+
+```toml
+# root dcr.toml
+[build]
+inherit = true
+language = "c"
+standard = "c17"
+
+# member inherits language and standard
+```

docs/self-update.mdx

@@ -0,0 +1,46 @@
+---
+sidebar_label: Self Update
+---
+
+# Self Update
+
+## dcr --update
+
+Automatic update to the latest version. Downloads a binary (not an archive) from GitHub Releases and replaces the current executable.
+
+```bash
+dcr --update
+```
+
+## How it works
+
+1. DCR detects the current platform and architecture
+2. Fetches the latest release from `api.github.com/repos/dexoron/dcr/releases/latest`
+3. Compares versions
+4. Downloads the matching asset (direct binary URL, not archive)
+5. Replaces the current executable via `self_replace`
+
+## Asset naming
+
+Pattern: `dcr-<triple>` or `dcr-<triple>.exe`
+
+| Platform | Asset name |
+|----------|-----------|
+| Linux x86_64 | `dcr-x86_64-unknown-linux-gnu` |
+| macOS x86_64 | `dcr-x86_64-apple-darwin` |
+| macOS ARM64 | `dcr-aarch64-apple-darwin` |
+| Windows x86_64 | `dcr-x86_64-pc-windows-msvc.exe` |
+
+## AUR
+
+If DCR was installed via AUR, `--update` shows a warning:
+
+```
+Update via package manager: yay/paru -Syu {package_name} or sudo pacman -Syu {package_name}
+```
+
+## Errors
+
+- Cannot detect platform — error
+- Cannot fetch release — error with URL
+- No write permission — error (use `sudo` or manual install)

docs/testing/running-tests.mdx

@@ -0,0 +1,45 @@
+---
+sidebar_label: Running tests
+---
+
+# Running Tests
+
+## Execution
+
+```bash
+dcr test
+```
+
+Builds the project, then compiles and runs test files from `tests/`.
+
+## Profiles
+
+```bash
+dcr test                     # debug (default)
+dcr test --release           # release
+dcr test --debug             # explicit debug
+```
+
+## Output
+
+```
+=====================
+  Testsuite summary
+=====================
+TOTAL: 5
+PASS: 3
+SKIP: 1
+FAIL: 1
+=====================
+```
+
+## Exit code
+
+- 0 — all tests passed (FAIL = 0)
+- 1 — test failures or build error
+
+## What gets built
+
+- All `.c` files from `tests/` (`.cpp` not supported)
+- Include path: `tests/` (for `dcr_test.h`)
+- Linked with project if `package.type = "lib"` or `kind = "staticlib"`/`"sharedlib"`

docs/testing/test-framework.mdx

@@ -0,0 +1,68 @@
+---
+sidebar_label: Test framework (EXPECT, TEST, ...)
+---
+
+# Test Framework
+
+DCR has a built-in minimal test framework for C.
+
+## Macros
+
+### `EXPECT(expr)`
+
+Asserts that an expression is true.
+
+```c
+EXPECT(1 + 1 == 2);
+EXPECT(ptr != NULL);
+```
+
+### `SKIP(reason)`
+
+Skips a test with a message.
+
+```c
+SKIP("not implemented on Windows");
+```
+
+### `TEST(name)`
+
+Defines a test.
+
+```c
+TEST(addition) {
+    EXPECT(1 + 1 == 2);
+    EXPECT(2 + 2 == 4);
+}
+```
+
+### `TEST_CASE(name)`
+
+Registers a test case.
+
+```c
+TEST_CASE(math) {
+    EXPECT(1 + 1 == 2);
+}
+```
+
+## Initialization
+
+```bash
+dcr test --init
+```
+
+Creates:
+- `tests/dcr_test.h` — framework header (do not edit)
+- `tests/test.c` — template with example test
+
+## Structure
+
+```
+tests/
+├── dcr_test.h      # framework (do not edit)
+├── test.c          # main tests
+└── ...             # additional .c test files
+```
+
+Only `.c` files are compiled (`.cpp` is not supported).

flake.lock

@@ -0,0 +1,135 @@
+{
+  "nodes": {
+    "fenix": {
+      "inputs": {
+        "nixpkgs": [
+          "nixpkgs"
+        ],
+        "rust-analyzer-src": "rust-analyzer-src"
+      },
+      "locked": {
+        "lastModified": 1780218205,
+        "narHash": "sha256-c4MSlBQw5MIDRkad9UNUUnBaOHAHnhuCXrDt90FDVrg=",
+        "owner": "nix-community",
+        "repo": "fenix",
+        "rev": "96e0fc9f1a9b37f6477fa11c3fd48575354773ed",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-community",
+        "repo": "fenix",
+        "type": "github"
+      }
+    },
+    "flake-utils": {
+      "inputs": {
+        "systems": "systems"
+      },
+      "locked": {
+        "lastModified": 1731533236,
+        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1779560665,
+        "narHash": "sha256-tpyBcxPpcQb8ukyNF7DoCwfSY3VPsxHoYwj00Cayv5o=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "64c08a7ca051951c8eae34e3e3cb1e202fe36786",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs_2": {
+      "locked": {
+        "lastModified": 1770107345,
+        "narHash": "sha256-tbS0Ebx2PiA1FRW8mt8oejR0qMXmziJmPaU1d4kYY9g=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "4533d9293756b63904b7238acb84ac8fe4c8c2c4",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "ref": "nixpkgs-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "fenix": "fenix",
+        "flake-utils": "flake-utils",
+        "nixpkgs": "nixpkgs",
+        "treefmt-nix": "treefmt-nix"
+      }
+    },
+    "rust-analyzer-src": {
+      "flake": false,
+      "locked": {
+        "lastModified": 1780179631,
+        "narHash": "sha256-61A3gj4V1DyPP6lVHTdui4+dvG66pkMZSMd1Kke3Rz8=",
+        "owner": "rust-lang",
+        "repo": "rust-analyzer",
+        "rev": "cce33f2f1565958787bb763ae751a6a5f56b95e3",
+        "type": "github"
+      },
+      "original": {
+        "owner": "rust-lang",
+        "ref": "nightly",
+        "repo": "rust-analyzer",
+        "type": "github"
+      }
+    },
+    "systems": {
+      "locked": {
+        "lastModified": 1681028828,
+        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
+        "owner": "nix-systems",
+        "repo": "default",
+        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-systems",
+        "repo": "default",
+        "type": "github"
+      }
+    },
+    "treefmt-nix": {
+      "inputs": {
+        "nixpkgs": "nixpkgs_2"
+      },
+      "locked": {
+        "lastModified": 1780220602,
+        "narHash": "sha256-eynAfOmbmxJnkp7YewvCEbShNnnYJ9gLLqkzsYtBPeM=",
+        "owner": "numtide",
+        "repo": "treefmt-nix",
+        "rev": "db947814a175b7ca6ded66e21383d938df01c227",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "treefmt-nix",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

flake.nix

@@ -0,0 +1,115 @@
+{
+  description = "DCR — Cargo-like utility for managing C/C++ projects";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+
+    flake-utils.url = "github:numtide/flake-utils";
+
+    treefmt-nix.url = "github:numtide/treefmt-nix";
+
+    fenix = {
+      url = "github:nix-community/fenix";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+  };
+
+  outputs = {
+    self,
+    nixpkgs,
+    flake-utils,
+    treefmt-nix,
+    fenix,
+  }:
+    flake-utils.lib.eachDefaultSystem (system: let
+      pkgs = import nixpkgs {
+        inherit system;
+      };
+
+      cargoToml = builtins.fromTOML (builtins.readFile ./Cargo.toml);
+      packageName = cargoToml.package.name;
+      packageVersion = cargoToml.package.version;
+
+      rustToolchain = fenix.packages.${system}.stable.toolchain;
+
+      rustPlatform = pkgs.makeRustPlatform {
+        cargo = rustToolchain;
+        rustc = rustToolchain;
+      };
+
+      treefmtEval = treefmt-nix.lib.evalModule pkgs {
+        projectRootFile = "flake.nix";
+
+        programs.alejandra.enable = true;
+        programs.rustfmt.enable = true;
+        programs.taplo.enable = true;
+      };
+
+      app = rustPlatform.buildRustPackage {
+        pname = packageName;
+        version = packageVersion;
+
+        src = ./.;
+
+        cargoLock.lockFile = ./Cargo.lock;
+
+        nativeBuildInputs = [
+          pkgs.pkg-config
+          pkgs.cmake
+          pkgs.perl
+        ];
+
+        buildInputs = pkgs.lib.optionals pkgs.stdenv.isDarwin [
+          pkgs.darwin.apple_sdk.frameworks.Security
+          pkgs.darwin.apple_sdk.frameworks.SystemConfiguration
+        ];
+
+        postInstall = ''
+          install -Dm644 man/man1/*.1 -t $out/share/man/man1/
+        '';
+
+        # Tests require external services; run separately.
+        doCheck = false;
+      };
+    in {
+      packages = {
+        default = app;
+        dcr = app;
+      };
+
+      apps = let
+        defaultApp =
+          (flake-utils.lib.mkApp {
+            drv = app;
+          })
+          // {
+            meta.description = "Run ${packageName}";
+          };
+      in {
+        default = defaultApp;
+        dcr = defaultApp;
+      };
+
+      checks = {
+        dcr = app;
+        formatting = treefmtEval.config.build.check self;
+      };
+
+      formatter = treefmtEval.config.build.wrapper;
+
+      devShells.default = pkgs.mkShell {
+        inputsFrom = [app];
+
+        packages = [
+          rustToolchain
+          pkgs.rust-analyzer
+
+          treefmtEval.config.build.wrapper
+        ];
+
+        shellHook = ''
+          export RUST_SRC_PATH="${rustToolchain}/lib/rustlib/src/rust/library"
+        '';
+      };
+    });
+}

install.ps1

@@ -47,10 +47,16 @@ function Select-Mode {
 }
 
 function Get-Target {
-    if ($env:PROCESSOR_ARCHITECTURE -ne 'AMD64') {
-        Fail "Only x86_64 Windows is supported, current architecture: $env:PROCESSOR_ARCHITECTURE"
+    $arch = $env:PROCESSOR_ARCHITECTURE
+    if ($env:PROCESSOR_ARCHITEW6432) {
+        $arch = $env:PROCESSOR_ARCHITEW6432
+    }
+    switch ($arch) {
+        'AMD64' { return 'x86_64-pc-windows-msvc' }
+        'ARM64' { return 'aarch64-pc-windows-msvc' }
+        'x86'   { return 'i686-pc-windows-msvc' }
+        default { Fail "Unsupported Windows architecture: $arch" }
     }
-    return 'x86_64-pc-windows-msvc'
 }
 
 function Fetch-ReleaseJson($channel) {

install.sh

@@ -4,6 +4,7 @@ set -Eeuo pipefail
 TMPDIR="/tmp/dcr-install"
 INSTALL_PATH="$HOME/.local/share/dcr"
 BINPATH="$HOME/.local/bin"
+MANPATH="${XDG_DATA_HOME:-$HOME/.local/share}/man"
 LOGFILE="$HOME/.cache/dcr-install.log"
 REPO_URL="https://github.com/dexoron/dcr"
 GITHUB_API_LATEST="https://api.github.com/repos/dexoron/dcr/releases/latest"
@@ -43,11 +44,20 @@ detect_target() {
     case "$os:$arch" in
         Linux:x86_64)                      TARGET_TRIPLE="x86_64-unknown-linux-gnu" ;;
         Linux:aarch64|Linux:arm64)         TARGET_TRIPLE="aarch64-unknown-linux-gnu" ;;
+        Linux:i686|Linux:i386)             TARGET_TRIPLE="i686-unknown-linux-gnu" ;;
+        Linux:armv7l|Linux:armv7)          TARGET_TRIPLE="armv7-unknown-linux-gnueabihf" ;;
+        Linux:riscv64)                     TARGET_TRIPLE="riscv64gc-unknown-linux-gnu" ;;
         Darwin:x86_64)                     TARGET_TRIPLE="x86_64-apple-darwin" ;;
         Darwin:arm64|Darwin:aarch64)       TARGET_TRIPLE="aarch64-apple-darwin" ;;
         FreeBSD:x86_64|FreeBSD:amd64)      TARGET_TRIPLE="x86_64-unknown-freebsd" ;;
+        FreeBSD:aarch64|FreeBSD:arm64)     TARGET_TRIPLE="aarch64-unknown-freebsd" ;;
+        FreeBSD:i686|FreeBSD:i386)         TARGET_TRIPLE="i686-unknown-freebsd" ;;
         OpenBSD:x86_64|OpenBSD:amd64)      TARGET_TRIPLE="x86_64-unknown-openbsd" ;;
+        OpenBSD:aarch64|OpenBSD:arm64)     TARGET_TRIPLE="aarch64-unknown-openbsd" ;;
+        OpenBSD:i686|OpenBSD:i386)         TARGET_TRIPLE="i686-unknown-openbsd" ;;
         NetBSD:x86_64|NetBSD:amd64)        TARGET_TRIPLE="x86_64-unknown-netbsd" ;;
+        NetBSD:aarch64|NetBSD:arm64)       TARGET_TRIPLE="aarch64-unknown-netbsd" ;;
+        NetBSD:i686|NetBSD:i386)           TARGET_TRIPLE="i686-unknown-netbsd" ;;
 
         *) error "Unsupported platform: $os/$arch"; exit 1 ;;
     esac
@@ -72,7 +82,7 @@ select_channel() {
     echo "Choose channel:"
     echo "  1) Latest stable release (default)"
     echo "  2) Latest dev (pre-release)"
-    read -r -p "Enter 1 or 2 [1]: " choice
+    read -r -p "Enter 1 or 2 [1]: " choice < /dev/tty
 
     case "${choice:-1}" in
         1) CHANNEL="stable" ;;
@@ -85,7 +95,7 @@ select_install_mode() {
     echo "Choose installation mode:"
     echo "  1) Download prebuilt binary from GitHub Release (recommended)"
     echo "  2) Build from git"
-    read -r -p "Enter 1 or 2 [1]: " choice
+    read -r -p "Enter 1 or 2 [1]: " choice < /dev/tty
 
     case "${choice:-1}" in
         1) INSTALL_MODE="release" ;;
@@ -190,6 +200,16 @@ install_link() {
     success "Command 'dcr' added to $BINPATH"
 }
 
+install_man() {
+    log "Installing man pages..."
+    local man_src="$TMPDIR/man/man1"
+    if [[ -d "$man_src" ]]; then
+        mkdir -p "$MANPATH/man1"
+        cp "$man_src"/*.1 "$MANPATH/man1/"
+        success "Man pages installed to $MANPATH/man1"
+    fi
+}
+
 check_path() {
     if ! echo "$PATH" | grep -q "$BINPATH"; then
         warn "Directory $BINPATH not found in PATH"
@@ -222,6 +242,7 @@ main() {
     fi
 
     install_link
+    install_man
     check_path
     cleanup
 
@@ -229,4 +250,4 @@ main() {
     log "Log saved to $LOGFILE"
 }
 
-main "$@"
+main "$@"

install_bsd.sh

@@ -4,6 +4,7 @@ set -eu
 TMPDIR="/tmp/dcr-install"
 INSTALL_PATH="$HOME/.local/share/dcr"
 BINPATH="$HOME/.local/bin"
+MANPATH="${XDG_DATA_HOME:-$HOME/.local/share}/man"
 LOGFILE="$HOME/.cache/dcr-install.log"
 REPO_URL="https://github.com/dexoron/dcr"
 GITHUB_API_LATEST="https://api.github.com/repos/dexoron/dcr/releases/latest"
@@ -39,8 +40,14 @@ detect_target() {
 
     case "$os:$arch" in
         FreeBSD:x86_64|FreeBSD:amd64)      TARGET_TRIPLE="x86_64-unknown-freebsd" ;;
+        FreeBSD:aarch64|FreeBSD:arm64)     TARGET_TRIPLE="aarch64-unknown-freebsd" ;;
+        FreeBSD:i686|FreeBSD:i386)         TARGET_TRIPLE="i686-unknown-freebsd" ;;
         OpenBSD:x86_64|OpenBSD:amd64)      TARGET_TRIPLE="x86_64-unknown-openbsd" ;;
+        OpenBSD:aarch64|OpenBSD:arm64)     TARGET_TRIPLE="aarch64-unknown-openbsd" ;;
+        OpenBSD:i686|OpenBSD:i386)         TARGET_TRIPLE="i686-unknown-openbsd" ;;
         NetBSD:x86_64|NetBSD:amd64)        TARGET_TRIPLE="x86_64-unknown-netbsd" ;;
+        NetBSD:aarch64|NetBSD:arm64)       TARGET_TRIPLE="aarch64-unknown-netbsd" ;;
+        NetBSD:i686|NetBSD:i386)           TARGET_TRIPLE="i686-unknown-netbsd" ;;
         DragonFly:x86_64|DragonFly:amd64)  TARGET_TRIPLE="x86_64-unknown-dragonfly" ;;
         *) error "Unsupported BSD platform: $os/$arch"; exit 1 ;;
     esac
@@ -181,6 +188,16 @@ install_link() {
     success "Command 'dcr' added to $BINPATH"
 }
 
+install_man() {
+    log "Installing man pages..."
+    man_src="$TMPDIR/man/man1"
+    if [ -d "$man_src" ]; then
+        mkdir -p "$MANPATH/man1"
+        cp "$man_src"/*.1 "$MANPATH/man1/"
+        success "Man pages installed to $MANPATH/man1"
+    fi
+}
+
 check_path() {
     if ! echo "$PATH" | grep -q "$BINPATH"; then
         warn "Directory $BINPATH not found in PATH"
@@ -213,6 +230,7 @@ main() {
     fi
 
     install_link
+    install_man
     check_path
     cleanup
 

man/man1/dcr-add.1

@@ -0,0 +1,42 @@
+.TH DCR-ADD 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-add \- Add a dependency to a DCR project
+.SH SYNOPSIS
+.B dcr add \fI<name>\fR \fI<source>\fR
+[\fB\-\-branch\fR \fI<b>\fR]
+[\fB\-\-tag\fR \fI<t>\fR]
+[\fB\-\-rev\fR \fI<r>\fR]
+.SH DESCRIPTION
+Adds a dependency to the project.
+.SH SOURCES
+.TP
+.B user/repo
+GitHub shorthand.
+.TP
+.B github:user/repo
+Full GitHub repository.
+.TP
+.B gitlab:user/repo
+GitLab repository.
+.TP
+.B git:host.com/user/repo
+Generic git repository.
+.TP
+.B path:./path/to/lib
+Local path dependency.
+.TP
+.B <version>
+Version from registry.
+.SH OPTIONS
+.TP
+.B \-\-branch \fI<name>\fR
+Use a specific branch.
+.TP
+.B \-\-tag \fI<name>\fR
+Use a specific tag.
+.TP
+.B \-\-rev \fI<hash>\fR
+Use a specific commit hash.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-tree (1)

man/man1/dcr-build.1

@@ -0,0 +1,37 @@
+.TH DCR-BUILD 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-build \- Compile a DCR project
+.SH SYNOPSIS
+.B dcr build
+[\fB\-\-debug\fR | \fB\-\-release\fR]
+[\fB\-\-target\fR \fI<triple>\fR]
+[\fB\-\-force\fR]
+[\fB\-\-clean\fR]
+[\fB\-\-verbose\fR]
+[\fB\-\-workspace\fR \fI<name>\fR]
+.SH DESCRIPTION
+Compiles the project. Default profile is \fB\-\-debug\fR.
+.SH OPTIONS
+.TP
+.B \-\-debug
+Build with debug profile (default). Enables debug symbols.
+.TP
+.B \-\-release
+Build with release profile. Enables full optimization.
+.TP
+.B \-\-target \fI<triple>\fR
+Cross-compile for the given target.
+.TP
+.B \-\-force
+Force a full rebuild, ignoring cached artifacts.
+.TP
+.B \-\-clean
+Clean before building.
+.TP
+.B \-\-verbose
+Print detailed build output including compiler commands.
+.TP
+.B \-\-workspace \fI<name>\fR
+Build a specific workspace member.
+.SH SEE ALSO
+.BR dcr (1)

man/man1/dcr-clean.1

@@ -0,0 +1,26 @@
+.TH DCR-CLEAN 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-clean \- Remove build artifacts
+.SH SYNOPSIS
+.B dcr clean
+[\fB\-\-debug\fR | \fB\-\-release\fR]
+[\fB\-\-target\fR \fI<triple>\fR]
+[\fB\-\-all\fR]
+.SH DESCRIPTION
+Removes build artifacts from the target directory.
+.SH OPTIONS
+.TP
+.B \-\-debug
+Clean debug artifacts (default).
+.TP
+.B \-\-release
+Clean release artifacts.
+.TP
+.B \-\-target \fI<triple>\fR
+Clean artifacts for a specific target.
+.TP
+.B \-\-all
+Clean all workspace members.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-build (1)

man/man1/dcr-fmt.1

@@ -0,0 +1,10 @@
+.TH DCR-FMT 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-fmt \- Format C/C++ source files
+.SH SYNOPSIS
+.B dcr fmt
+.SH DESCRIPTION
+Formats all C/C++ source files using clang-format. Scans \fBsrc/\fR
+and \fBtests/\fR directories recursively.
+.SH SEE ALSO
+.BR dcr (1)

man/man1/dcr-gen.1

@@ -0,0 +1,23 @@
+.TH DCR-GEN 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-gen \- Generate IDE and tooling integration files
+.SH SYNOPSIS
+.B dcr gen \fI<subcommand>\fR
+.SH DESCRIPTION
+Generates IDE and tooling integration files for DCR projects.
+.SH SUBCOMMANDS
+.TP
+.B project-info
+Print project metadata as JSON to stdout.
+.TP
+.B compile-commands
+Generate \fBcompile_commands.json\fR for IDE tooling.
+.TP
+.B vscode
+Generate \fB.vscode/\fR integration files (tasks, launch configurations).
+.TP
+.B clion
+Generate \fB.idea/\fR integration files for CLion.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-build (1)

man/man1/dcr-init.1

@@ -0,0 +1,11 @@
+.TH DCR-INIT 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-init \- Initialize a directory as a DCR project
+.SH SYNOPSIS
+.B dcr init
+.SH DESCRIPTION
+Initializes the current directory as a DCR project. The directory must
+be empty.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-new (1)

man/man1/dcr-new.1

@@ -0,0 +1,13 @@
+.TH DCR-NEW 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-new \- Create a new DCR project
+.SH SYNOPSIS
+.B dcr new \fI<name>\fR
+.SH DESCRIPTION
+Creates a new C/C++ project with the given name. The name may only
+contain ASCII letters, digits, underscores and hyphens.
+.SH EXAMPLE
+.B dcr new my-project
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-init (1)

man/man1/dcr-run.1

@@ -0,0 +1,35 @@
+.TH DCR-RUN 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-run \- Build and run a DCR project
+.SH SYNOPSIS
+.B dcr run
+[\fB\-\-debug\fR | \fB\-\-release\fR]
+[\fB\-\-target\fR \fI<triple>\fR]
+[\fB\-\-force\fR]
+[\fB\-\-clean\fR]
+[\fB\-\-verbose\fR]
+.SH DESCRIPTION
+Builds and runs the project. Only available for projects with
+\fBkind = "bin"\fR.
+.SH OPTIONS
+.TP
+.B \-\-debug
+Run with debug profile (default).
+.TP
+.B \-\-release
+Run with release profile.
+.TP
+.B \-\-target \fI<triple>\fR
+Cross-compile for the given target.
+.TP
+.B \-\-force
+Force a full rebuild.
+.TP
+.B \-\-clean
+Clean before building.
+.TP
+.B \-\-verbose
+Print detailed build output.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-build (1)

man/man1/dcr-setup.1

@@ -0,0 +1,11 @@
+.TH DCR-SETUP 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-setup \- Set up DCR registries
+.SH SYNOPSIS
+.B dcr setup
+.SH DESCRIPTION
+Sets up DCR registries. Downloads and indexes package registries
+for dependency resolution.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-add (1)

man/man1/dcr-test.1

@@ -0,0 +1,24 @@
+.TH DCR-TEST 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-test \- Run project tests
+.SH SYNOPSIS
+.B dcr test
+[\fB\-\-init\fR]
+[\fB\-\-debug\fR | \fB\-\-release\fR]
+.SH ALIASES
+.B dcr tests
+.SH DESCRIPTION
+Runs project tests and prints a unified testsuite report.
+.SH OPTIONS
+.TP
+.B \-\-init
+Create \fBtests/dcr_test.h\fR in the current project.
+.TP
+.B \-\-debug
+Build and run tests with debug profile (default).
+.TP
+.B \-\-release
+Build and run tests with release profile.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-build (1)

man/man1/dcr-tree.1

@@ -0,0 +1,11 @@
+.TH DCR-TREE 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr-tree \- Display the dependency tree
+.SH SYNOPSIS
+.B dcr tree
+.SH DESCRIPTION
+Displays the dependency tree of the current project, showing all
+transitive dependencies and their versions.
+.SH SEE ALSO
+.BR dcr (1),
+.BR dcr-add (1)

man/man1/dcr.1

@@ -0,0 +1,204 @@
+.TH DCR 1 "2026-06-02" "dcr 0.7.0" "DCR Manual"
+.SH NAME
+dcr \- Cargo\-like build tool and package manager for C/C++ projects
+.SH SYNOPSIS
+.B dcr
+[\fIcommand\fR] [\fIoptions\fR]
+.SH DESCRIPTION
+DCR is a comprehensive build tool and package manager for C and C++ projects,
+inspired by Cargo from the Rust ecosystem. It handles project creation,
+building, dependency management, testing, formatting, and IDE integration.
+.SH COMMANDS
+.TP
+.B new \fI<name>\fR
+Create a new C/C++ project with the given name. Only ASCII letters, digits,
+underscores and hyphens are allowed.
+.TP
+.B init
+Initialize the current (empty) directory as a DCR project.
+.TP
+.B build [\fIoptions\fR]
+Compile the project. Default profile is \fB\-\-debug\fR.
+.TP
+.B run [\fIoptions\fR]
+Build and run the project. Only available for binary projects.
+.TP
+.B clean [\fIoptions\fR]
+Remove build artifacts from the target directory.
+.TP
+.B test [\fI\-\-init\fR] [\fI\-\-debug\fR|\fI\-\-release\fR]
+Run project tests (alias: \fBdcr tests\fR).
+.TP
+.B add \fI<name>\fR \fI<source>\fR [\fIoptions\fR]
+Add a dependency to the project.
+.TP
+.B tree
+Display the dependency tree of the current project.
+.TP
+.B fmt
+Format all C/C++ source files using clang-format.
+.TP
+.B gen \fI<subcommand>\fR
+Generate IDE integration files (vscode, clion, compile-commands, project-info).
+.TP
+.B setup
+Set up DCR registries for dependency resolution.
+.SH GLOBAL FLAGS
+.TP
+.B \-\-help
+Show this help message and exit.
+.TP
+.B \-\-version
+Print version information and exit.
+.TP
+.B \-\-update
+Update DCR to the latest version from GitHub Releases.
+.SH BUILD OPTIONS
+The following options apply to \fBbuild\fR and \fBrun\fR commands:
+.TP
+.B \-\-debug
+Build with debug profile (default). Enables debug symbols and minimal optimization.
+.TP
+.B \-\-release
+Build with release profile. Enables full optimization without debug symbols.
+.TP
+.B \-\-target \fI<triple>\fR
+Cross-compile for the given target (e.g. \fBaarch64-linux-gnu\fR, \fBx86_64-w64-mingw32\fR).
+Short names like \fBlinux\fR, \fBmacos\fR, \fBwindows\fR are also supported.
+.TP
+.B \-\-force
+Force a full rebuild, ignoring cached build artifacts.
+.TP
+.B \-\-clean
+Clean build artifacts before building.
+.TP
+.B \-\-verbose
+Print detailed build output including compiler commands.
+.TP
+.B \-\-workspace \fI<name>\fR
+Build a specific workspace member.
+.SH CLEAN OPTIONS
+.TP
+.B \-\-debug
+Clean debug artifacts (default).
+.TP
+.B \-\-release
+Clean release artifacts.
+.TP
+.B \-\-target \fI<triple>\fR
+Clean artifacts for a specific target.
+.TP
+.B \-\-all
+Clean all workspace members.
+.SH ADD OPTIONS
+.TP
+.B \-\-branch \fI<name>\fR
+Use a specific branch when adding a git dependency.
+.TP
+.B \-\-tag \fI<name>\fR
+Use a specific tag when adding a git dependency.
+.TP
+.B \-\-rev \fI<hash>\fR
+Use a specific commit hash when adding a git dependency.
+.SH DEPENDENCY SOURCES
+.TP
+.B user/repo
+GitHub shorthand (e.g. \fBuser/repo\fR).
+.TP
+.B github:user/repo
+Full GitHub repository URL shorthand.
+.TP
+.B gitlab:user/repo
+GitLab repository URL shorthand.
+.TP
+.B git:host.com/user/repo
+Generic git repository.
+.TP
+.B path:./path/to/lib
+Local path dependency.
+.TP
+.B \fI<version>\fR
+Version from registry (e.g. \fB1.2.3\fR).
+.SH GEN SUBCOMMANDS
+.TP
+.B project-info
+Print project metadata as JSON to stdout.
+.TP
+.B compile-commands
+Generate \fBcompile_commands.json\fR for IDE tooling.
+.TP
+.B vscode
+Generate \fB.vscode/\fR integration files (tasks, launch configurations).
+.TP
+.B clion
+Generate \fB.idea/\fR integration files for CLion.
+.SH TEST OPTIONS
+.TP
+.B \-\-init
+Create \fBtests/dcr_test.h\fR in the current project.
+.TP
+.B \-\-debug
+Build and run tests with debug profile (default).
+.TP
+.B \-\-release
+Build and run tests with release profile.
+.SH PROJECT CONFIGURATION
+DCR uses \fBdcr.toml\fR for project configuration. Key settings include:
+.TP
+.B package.name
+Project name (required).
+.TP
+.B package.version
+Project version (default: \fB0.1.0\fR).
+.TP
+.B build.language
+Programming language: \fBc\fR or \fBc++\fR (default: \fBc\fR).
+.TP
+.B build.standard
+Language standard (e.g. \fBc11\fR, \fBc17\fR, \fBc++20\fR; default: \fBc11\fR).
+.TP
+.B build.compiler
+Compiler to use: \fBclang\fR, \fBgcc\fR, \fBcl\fR, \fBclang-cl\fR (default: \fBclang\fR).
+.TP
+.B build.kind
+Output type: \fBbin\fR, \fBlib\fR (static or dynamic), \fBstaticlib\fR, \fBsharedlib\fR (default: \fBbin\fR).
+.SH FILES
+.TP
+.I dcr.toml
+Project manifest file.
+.TP
+.I ~/.dcr/config.toml
+User-level DCR configuration.
+.TP
+.I ~/.dcr/index.json
+Local registry index.
+.SH ENVIRONMENT
+.TP
+.B DCR_COMPILER
+Override the compiler used for building.
+.TP
+.B DCR_CC
+Alternative way to override the compiler.
+.SH EXAMPLES
+.TP
+Create a new project:
+.B dcr new hello
+.TP
+Initialize from current directory:
+.B dcr init
+.TP
+Build with release profile:
+.B dcr build \-\-release
+.TP
+Cross-compile for Windows:
+.B dcr build \-\-target windows
+.TP
+Add a dependency:
+.BR "dcr add curl git:https://github.com/curl/curl" .
+.TP
+Generate VS Code integration:
+.B dcr gen vscode
+.SH SEE ALSO
+.IR https://dcr.dexoron.su ", " https://github.com/dexoron/dcr
+.SH AUTHORS
+Dexoron (Bezotechestvo Vladimir) <main@dexoron.su>

packaging/aur/dcr/PKGBUILD

@@ -27,4 +27,7 @@ package() {
   cd "$srcdir/$pkgname-$pkgver"
   install -Dm755 "target/release/dcr" "$pkgdir/usr/bin/dcr"
   install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
+  for manpage in man/man1/*.1; do
+    install -Dm644 "$manpage" "$pkgdir/usr/share/man/man1/$(basename "$manpage")"
+  done
 }

packaging/snap/snapcraft.yaml

@@ -1,4 +1,4 @@
-name: dcr
+name: dcrup
 base: core22
 version: '0.6.9'
 summary: Cargo-like utility to manage C/C++ projects

src/cli/add.rs

@@ -19,7 +19,7 @@ use crate::core::config::Config;
 use crate::core::deps::register;
 use crate::utils::fs::find_project_root;
 use crate::utils::log::error;
-use crate::utils::text::{BOLD_GREEN, colored};
+use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, colored, printc};
 use toml::Value;
 use toml::map::Map;
 
@@ -34,6 +34,31 @@ pub struct AddArgs {
 }
 
 pub fn add(args: &[String]) -> i32 {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc(
+            "    dcr add <name> <source> [--branch <b>] [--tag <t>] [--rev <r>]",
+            BOLD_CYAN,
+        );
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Adds a dependency to the project.");
+        println!();
+        printc("SOURCES:", BOLD_GREEN);
+        println!("    user/repo                 GitHub shorthand");
+        println!("    github:user/repo          GitHub repository");
+        println!("    gitlab:user/repo          GitLab repository");
+        println!("    git:host.com/user/repo    Generic git repository");
+        println!("    path:./path/to/lib        Local path dependency");
+        println!("    <version>                 Version from registry");
+        println!();
+        printc("OPTIONS:", BOLD_GREEN);
+        println!("    --branch <b>    Use a specific branch");
+        println!("    --tag <t>       Use a specific tag");
+        println!("    --rev <r>       Use a specific commit hash");
+        return 0;
+    }
+
     let add_args = match parse_add_args(args) {
         Ok(a) => a,
         Err(code) => return code,

src/cli/build.rs

@@ -23,13 +23,13 @@ use crate::core::config::Config;
 use crate::core::deps::{register, resolve_deps};
 use crate::core::workspace::parse_workspace;
 use crate::utils::build::{
-    get_bool_with_profile, get_config_opt, get_config_str, get_language_with_profile,
-    normalize_target_os, parse_version_info, profile_table, resolve_compiler,
-    resolve_pkg_config_flags, resolve_tool,
+    default_target_triple, get_bool_with_profile, get_config_opt, get_config_str,
+    get_language_with_profile, normalize_target_os, parse_version_info, prepend_clang_target_flag,
+    profile_table, resolve_compiler, resolve_pkg_config_flags, resolve_tool,
 };
 use crate::utils::fs::{check_dir, find_project_root, with_dir};
 use crate::utils::log::error;
-use crate::utils::text::{BOLD_GREEN, colored};
+use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, colored, printc};
 use glob::glob;
 use sha2::{Digest, Sha256};
 use std::fs;
@@ -42,6 +42,27 @@ static BUILD_INTERRUPTED: AtomicBool = AtomicBool::new(false);
 static SIGNAL_HANDLER: Once = Once::new();
 
 pub fn build(args: &[String]) -> i32 {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc(
+            "    dcr build [--debug | --release] [--target <triple>] [--force] [--clean] [--verbose]",
+            BOLD_CYAN,
+        );
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Compiles the project. Default profile is --debug.");
+        println!();
+        printc("OPTIONS:", BOLD_GREEN);
+        println!("    --debug              Build with debug profile (default)");
+        println!("    --release            Build with release profile");
+        println!("    --target <triple>    Cross-compile for the given target");
+        println!("    --force              Force a full rebuild");
+        println!("    --clean              Clean before building");
+        println!("    --verbose            Print detailed build output");
+        println!("    --workspace <name>   Build a specific workspace member");
+        return 0;
+    }
+
     install_signal_handler();
     BUILD_INTERRUPTED.store(false, Ordering::SeqCst);
     let start_dir = match std::env::current_dir() {
@@ -79,27 +100,7 @@ pub fn build(args: &[String]) -> i32 {
         }
     }
     if flags.target.is_none() {
-        let default_target = if cfg!(target_os = "linux") {
-            format!("{}-unknown-linux-gnu", std::env::consts::ARCH)
-        } else if cfg!(target_os = "macos") {
-            "x86_64-apple-darwin".to_string()
-        } else if cfg!(target_os = "windows") {
-            "x86_64-pc-windows-msvc".to_string()
-        } else if cfg!(any(
-            target_os = "freebsd",
-            target_os = "openbsd",
-            target_os = "netbsd",
-            target_os = "dragonfly"
-        )) {
-            format!(
-                "{}-unknown-{}",
-                std::env::consts::ARCH,
-                std::env::consts::OS
-            )
-        } else {
-            "unknown".to_string()
-        };
-        flags.target = Some(default_target);
+        flags.target = Some(default_target_triple());
     }
     if flags.clean {
         let mut clean_args = Vec::new();
@@ -697,19 +698,13 @@ fn build_project_at(
             tc_cxx.as_deref(),
             tc_as.as_deref(),
         );
-        if let Some(t) = build_target
-            && !t.trim().is_empty()
-            && resolved_compiler.to_lowercase().contains("clang")
-        {
-            let target_flag = format!("--target={}", t.trim());
-            if !build_cflags
-                .iter()
-                .any(|f| f == &target_flag || f.starts_with("--target="))
-            {
-                build_cflags.insert(0, target_flag);
-            }
-        }
         let resolved_linker = resolve_tool("DCR_LD", tc_ld.as_deref());
+        prepend_clang_target_flag(&mut build_cflags, build_target, &resolved_compiler);
+        prepend_clang_target_flag(
+            &mut build_ldflags,
+            build_target,
+            resolved_linker.as_deref().unwrap_or(&resolved_compiler),
+        );
         let resolved_archiver = resolve_tool("DCR_AR", tc_ar.as_deref());
 
         let out_dir_config = get_build_string_with_profile(&config, "out_dir", profile);

src/cli/clean.rs

@@ -18,15 +18,33 @@
 use crate::config::flags;
 use crate::core::config::Config;
 use crate::core::workspace::parse_workspace;
-use crate::utils::build::parse_version_info;
+use crate::utils::build::{default_target_triple, parse_version_info};
 use crate::utils::fs::{check_dir, find_project_root, with_dir};
 use crate::utils::log::{error, warn};
-use crate::utils::text::{BOLD_GREEN, colored};
+use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, colored, printc};
 use glob::glob;
 use std::fs;
 use std::path::Path;
 
 pub fn clean(args: &[String]) -> i32 {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc(
+            "    dcr clean [--debug | --release] [--target <triple>] [--all]",
+            BOLD_CYAN,
+        );
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Removes build artifacts from the target directory.");
+        println!();
+        printc("OPTIONS:", BOLD_GREEN);
+        println!("    --debug              Clean debug artifacts (default)");
+        println!("    --release            Clean release artifacts");
+        println!("    --target <triple>    Clean artifacts for a specific target");
+        println!("    --all                Clean all workspace members");
+        return 0;
+    }
+
     let start_dir = match std::env::current_dir() {
         Ok(dir) => dir,
         Err(_) => {
@@ -118,28 +136,7 @@ fn clean_from_root(root: &Path, flags: &CleanFlags) -> Result<(), String> {
                 .map(|s| s.trim().to_string())
                 .filter(|s| !s.is_empty())
         })
-        .or_else(|| {
-            Some(if cfg!(target_os = "linux") {
-                format!("{}-unknown-linux-gnu", std::env::consts::ARCH)
-            } else if cfg!(target_os = "macos") {
-                "x86_64-apple-darwin".to_string()
-            } else if cfg!(target_os = "windows") {
-                "x86_64-pc-windows-msvc".to_string()
-            } else if cfg!(any(
-                target_os = "freebsd",
-                target_os = "openbsd",
-                target_os = "netbsd",
-                target_os = "dragonfly"
-            )) {
-                format!(
-                    "{}-unknown-{}",
-                    std::env::consts::ARCH,
-                    std::env::consts::OS
-                )
-            } else {
-                "unknown".to_string()
-            })
-        });
+        .or_else(|| Some(default_target_triple()));
 
     if flags.all
         && let Some(workspace) = parse_workspace(

src/cli/flag_update.rs

@@ -16,9 +16,10 @@
 // along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 use crate::utils::log::{error, warn};
-use reqwest::blocking::Client;
+use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, printc};
 use serde::Deserialize;
 use std::fs;
+use std::io::Read;
 use std::path::{Path, PathBuf};
 #[cfg(target_os = "linux")]
 use std::process::Command;
@@ -39,6 +40,15 @@ struct ReleaseAsset {
 }
 
 pub fn flag_update(args: &[String]) -> i32 {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc("    dcr --update", BOLD_CYAN);
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Updates DCR to the latest version from GitHub Releases.");
+        return 0;
+    }
+
     if !args.is_empty() {
         warn("Command does not support additional arguments");
         return 1;
@@ -62,15 +72,8 @@ pub fn flag_update(args: &[String]) -> i32 {
 
     let current_version = env!("CARGO_PKG_VERSION");
     let target = env!("DCR_TARGET");
-    let client = match Client::builder().user_agent("dcr-updater").build() {
-        Ok(client) => client,
-        Err(_) => {
-            error("Failed to initialize HTTP client");
-            return 1;
-        }
-    };
 
-    let release = match fetch_latest_release(&client) {
+    let release = match fetch_latest_release() {
         Ok(release) => release,
         Err(err) => {
             error(&format!("Failed to check for updates: {err}"));
@@ -94,7 +97,7 @@ pub fn flag_update(args: &[String]) -> i32 {
         return 1;
     };
 
-    let bytes = match download_asset(&client, &asset.browser_download_url) {
+    let bytes = match download_asset(&asset.browser_download_url) {
         Ok(bytes) => bytes,
         Err(err) => {
             error(&format!("Failed to download update: {err}"));
@@ -121,35 +124,35 @@ pub fn flag_update(args: &[String]) -> i32 {
     0
 }
 
-fn fetch_latest_release(client: &Client) -> Result<Release, String> {
-    let response = client
-        .get(LATEST_RELEASE_URL)
-        .send()
-        .map_err(|_| "GitHub API request failed".to_string())?;
-
-    if !response.status().is_success() {
-        return Err(format!("GitHub API returned status {}", response.status()));
-    }
+fn fetch_latest_release() -> Result<Release, String> {
+    let response = ureq::get(LATEST_RELEASE_URL)
+        .set("User-Agent", "dcr-updater")
+        .call()
+        .map_err(|e| match e {
+            ureq::Error::Status(code, _) => format!("GitHub API returned status {code}"),
+            ureq::Error::Transport(e) => format!("GitHub API request failed: {e}"),
+        })?;
 
     response
-        .json::<Release>()
+        .into_json::<Release>()
         .map_err(|_| "GitHub API response has an unexpected format".to_string())
 }
 
-fn download_asset(client: &Client, url: &str) -> Result<Vec<u8>, String> {
-    let response = client
-        .get(url)
-        .send()
-        .map_err(|_| "Download request failed".to_string())?;
+fn download_asset(url: &str) -> Result<Vec<u8>, String> {
+    let response = ureq::get(url)
+        .set("User-Agent", "dcr-updater")
+        .call()
+        .map_err(|e| match e {
+            ureq::Error::Status(code, _) => format!("Download returned status {code}"),
+            ureq::Error::Transport(e) => format!("Download request failed: {e}"),
+        })?;
 
-    if !response.status().is_success() {
-        return Err(format!("Download returned status {}", response.status()));
-    }
-
-    response
-        .bytes()
-        .map(|bytes| bytes.to_vec())
-        .map_err(|_| "Failed to read downloaded data".to_string())
+    let mut reader = response.into_reader();
+    let mut data = Vec::new();
+    reader
+        .read_to_end(&mut data)
+        .map_err(|_| "Failed to read downloaded data".to_string())?;
+    Ok(data)
 }
 
 fn asset_candidates(target: &str) -> Vec<String> {

src/cli/fmt.rs

@@ -16,11 +16,21 @@
 // along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 use crate::utils::log::error;
-use crate::utils::text::{BOLD_GREEN, colored};
+use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, colored, printc};
 use glob::glob;
 use std::process::Command;
 
-pub fn fmt(_args: &[String]) -> i32 {
+pub fn fmt(args: &[String]) -> i32 {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc("    dcr fmt", BOLD_CYAN);
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Formats all C/C++ source files using clang-format.");
+        println!("    Scans src/ and tests/ directories recursively.");
+        return 0;
+    }
+
     let patterns = [
         "src/**/*.c",
         "src/**/*.cpp",

src/cli/gen.rs

@@ -27,6 +27,7 @@ use crate::utils::build::{
 };
 use crate::utils::fs::find_project_root;
 use crate::utils::log::error;
+use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, printc};
 use std::path::{Path, PathBuf};
 
 /// Like `deps::resolve_deps` but does NOT require lib directories to exist.
@@ -186,13 +187,30 @@ pub struct ProjectInfo {
 
 pub fn r#gen(args: &[String]) -> i32 {
     let subcommand = match args.first() {
+        Some(s) if s == "--help" => {
+            printc("USAGE:", BOLD_GREEN);
+            printc("    dcr gen <subcommand>", BOLD_CYAN);
+            println!();
+            printc("DESCRIPTION:", BOLD_GREEN);
+            println!("    Generates IDE and tooling integration files.");
+            println!();
+            printc("SUBCOMMANDS:", BOLD_GREEN);
+            println!("    project-info      Print project metadata as JSON");
+            println!("    compile-commands  Generate compile_commands.json");
+            println!("    vscode            Generate .vscode/ integration files");
+            println!("    clion             Generate .idea/ integration files");
+            return 0;
+        }
         Some(s) => s.as_str(),
         None => {
-            eprintln!("Usage: dcr gen <subcommand>");
-            eprintln!("  project-info      Print project metadata as JSON");
-            eprintln!("  compile-commands  Generate compile_commands.json");
-            eprintln!("  vscode            Generate .vscode/ integration files");
-            eprintln!("  clion             Generate .idea/ integration files");
+            printc("USAGE:", BOLD_GREEN);
+            printc("    dcr gen <subcommand>", BOLD_CYAN);
+            println!();
+            printc("SUBCOMMANDS:", BOLD_GREEN);
+            println!("    project-info      Print project metadata as JSON");
+            println!("    compile-commands  Generate compile_commands.json");
+            println!("    vscode            Generate .vscode/ integration files");
+            println!("    clion             Generate .idea/ integration files");
             return 1;
         }
     };

src/cli/init.rs

@@ -16,7 +16,8 @@
 // along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 use crate::config::FILE_MAIN_C;
-use crate::core::config::Config;
+use crate::core::config::{Config, validate_package_name};
+use crate::core::vcs::VcsKind;
 use crate::utils::fs::check_dir;
 use crate::utils::log::{error, warn};
 use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, colored, printc};
@@ -25,7 +26,35 @@ use std::io::Write;
 use toml::Value;
 
 pub fn init(args: &[String]) -> i32 {
-    if !args.is_empty() {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc("    dcr init [--vcs <git|none>]", BOLD_CYAN);
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Initializes the current directory as a DCR project.");
+        println!("    The directory must be empty.");
+        return 0;
+    }
+
+    let mut vcs_str = None;
+    let mut clean_args = Vec::new();
+    let mut iter = args.iter();
+    while let Some(arg) = iter.next() {
+        if arg == "--vcs" {
+            if let Some(val) = iter.next() {
+                vcs_str = Some(val.clone());
+            } else {
+                error("--vcs requires a value");
+                return 1;
+            }
+        } else if let Some(stripped) = arg.strip_prefix("--vcs=") {
+            vcs_str = Some(stripped.to_string());
+        } else {
+            clean_args.push(arg.clone());
+        }
+    }
+
+    if !clean_args.is_empty() {
         warn("Command does not support additional arguments");
         return 1;
     }
@@ -41,6 +70,15 @@ pub fn init(args: &[String]) -> i32 {
         return 1;
     }
 
+    if let Err(e) = validate_package_name(&project_name) {
+        error(&format!(
+            "Invalid project name `{}`: {}",
+            colored(&project_name, BOLD_CYAN),
+            e
+        ));
+        return 1;
+    }
+
     let cwd = std::env::current_dir()
         .map(|v| v.to_string_lossy().to_string())
         .unwrap_or_else(|_| ".".to_string());
@@ -87,6 +125,40 @@ pub fn init(args: &[String]) -> i32 {
         colored("src/main.c", BOLD_CYAN)
     );
 
+    // settings VCS
+    let mut vcs_kind = VcsKind::Git;
+    if let Some(ref vcs_val) = vcs_str {
+        match VcsKind::parse(vcs_val) {
+            Ok(kind) => vcs_kind = kind,
+            Err(e) => {
+                error(&e);
+                return 1;
+            }
+        }
+    } else if let Ok(cwd_path) = std::env::current_dir()
+        && crate::core::vcs::find_existing_vcs(&cwd_path).is_some()
+    {
+        vcs_kind = VcsKind::None;
+    }
+
+    if vcs_kind == VcsKind::Git {
+        if crate::utils::git::is_git_available() {
+            let project_path = std::path::Path::new(".");
+            if let Err(e) = crate::core::vcs::init_vcs(vcs_kind, project_path) {
+                warn(&format!("Failed to initialize git repository: {}", e));
+            } else {
+                println!(
+                    "    {} Initialized git repository",
+                    colored("✔", BOLD_GREEN)
+                );
+            }
+        } else {
+            warn(
+                "Git is not installed or not found in PATH. Skipping Git repository initialization.",
+            );
+        }
+    }
+
     println!(
         "Project `{}` successfully created\n",
         colored(project_name.as_str(), BOLD_GREEN)

src/cli/new.rs

@@ -16,7 +16,8 @@
 // along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 use crate::config::FILE_MAIN_C;
-use crate::core::config::Config;
+use crate::core::config::{Config, validate_package_name};
+use crate::core::vcs::VcsKind;
 use crate::utils::fs::check_dir;
 use crate::utils::log::{error, warn};
 use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, colored, printc};
@@ -25,23 +26,60 @@ use std::io::Write;
 use toml::Value;
 
 pub fn new(args: &[String]) -> i32 {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc("    dcr new <name> [--vcs <git|none>]", BOLD_CYAN);
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Creates a new C/C++ project with the given name.");
+        println!("    The name may only contain ASCII letters, digits, '_' and '-'.");
+        return 0;
+    }
+
     let items = check_dir(None).unwrap_or_default();
 
-    if args.is_empty() {
+    let mut vcs_str = None;
+    let mut clean_args = Vec::new();
+    let mut iter = args.iter();
+    while let Some(arg) = iter.next() {
+        if arg == "--vcs" {
+            if let Some(val) = iter.next() {
+                vcs_str = Some(val.clone());
+            } else {
+                error("--vcs requires a value");
+                return 1;
+            }
+        } else if let Some(stripped) = arg.strip_prefix("--vcs=") {
+            vcs_str = Some(stripped.to_string());
+        } else {
+            clean_args.push(arg.clone());
+        }
+    }
+
+    if clean_args.is_empty() {
         error("Project name not specified");
         return 1;
     }
-    if args.len() > 1 {
+    if clean_args.len() > 1 {
         warn("Command does not support additional arguments");
         return 1;
     }
 
-    let project_name = &args[0];
+    let project_name = &clean_args[0];
     println!(
         "Creating a Project `{}`...",
         colored(project_name, BOLD_CYAN)
     );
 
+    if let Err(e) = validate_package_name(project_name) {
+        error(&format!(
+            "Invalid project name `{}`: {}",
+            colored(project_name, BOLD_CYAN),
+            e
+        ));
+        return 1;
+    }
+
     if items.contains(project_name) {
         error(&format!(
             "Directory `{}` already exists\n",
@@ -108,6 +146,40 @@ pub fn new(args: &[String]) -> i32 {
         colored("src/main.c", BOLD_CYAN)
     );
 
+    // settings VCS
+    let mut vcs_kind = VcsKind::Git;
+    if let Some(ref vcs_val) = vcs_str {
+        match VcsKind::parse(vcs_val) {
+            Ok(kind) => vcs_kind = kind,
+            Err(e) => {
+                error(&e);
+                return 1;
+            }
+        }
+    } else if let Ok(cwd) = std::env::current_dir()
+        && crate::core::vcs::find_existing_vcs(&cwd).is_some()
+    {
+        vcs_kind = VcsKind::None;
+    }
+
+    if vcs_kind == VcsKind::Git {
+        if crate::utils::git::is_git_available() {
+            let project_path = std::path::Path::new(project_name);
+            if let Err(e) = crate::core::vcs::init_vcs(vcs_kind, project_path) {
+                warn(&format!("Failed to initialize git repository: {}", e));
+            } else {
+                println!(
+                    "    {} Initialized git repository",
+                    colored("✔", BOLD_GREEN)
+                );
+            }
+        } else {
+            warn(
+                "Git is not installed or not found in PATH. Skipping Git repository initialization.",
+            );
+        }
+    }
+
     println!(
         "Project `{}` successfully created\n",
         colored(project_name, BOLD_GREEN)

src/cli/run.rs

@@ -19,11 +19,11 @@ use crate::cli::build::build;
 use crate::cli::flags::parse_build_run_flags;
 use crate::core::config::Config;
 use crate::core::runner::run_binary;
-use crate::utils::build::{normalize_target_os, parse_version_info};
+use crate::utils::build::{default_target_triple, normalize_target_os, parse_version_info};
 use crate::utils::fs::find_project_root;
 use crate::utils::fs::with_dir;
 use crate::utils::log::error;
-use crate::utils::text::{BOLD_GREEN, colored};
+use crate::utils::text::{BOLD_CYAN, BOLD_GREEN, colored, printc};
 use std::path::Path;
 use std::process::Command;
 
@@ -56,6 +56,26 @@ fn get_run_cmd(
 }
 
 pub fn run(args: &[String]) -> i32 {
+    if args.first().is_some_and(|a| a == "--help") {
+        printc("USAGE:", BOLD_GREEN);
+        printc(
+            "    dcr run [--debug | --release] [--target <triple>] [--force] [--clean] [--verbose]",
+            BOLD_CYAN,
+        );
+        println!();
+        printc("DESCRIPTION:", BOLD_GREEN);
+        println!("    Builds and runs the project. Only available for kind = \"bin\".");
+        println!();
+        printc("OPTIONS:", BOLD_GREEN);
+        println!("    --debug              Run with debug profile (default)");
+        println!("    --release            Run with release profile");
+        println!("    --target <triple>    Cross-compile for the given target");
+        println!("    --force              Force a full rebuild");
+        println!("    --clean              Clean before building");
+        println!("    --verbose            Print detailed build output");
+        return 0;
+    }
+
     let start_dir = match std::env::current_dir() {
         Ok(dir) => dir,
         Err(_) => {
@@ -158,27 +178,7 @@ fn run_project(
     // If no target specified, use default host target for target-specific config
     let mut target = flags.target.clone();
     if target.is_none() {
-        let default_target = if cfg!(target_os = "linux") {
-            format!("{}-unknown-linux-gnu", std::env::consts::ARCH)
-        } else if cfg!(target_os = "macos") {
-            "x86_64-apple-darwin".to_string()
-        } else if cfg!(target_os = "windows") {
-            "x86_64-pc-windows-msvc".to_string()
-        } else if cfg!(any(
-            target_os = "freebsd",
-            target_os = "openbsd",
-            target_os = "netbsd",
-            target_os = "dragonfly"
-        )) {
-            format!(
-                "{}-unknown-{}",
-                std::env::consts::ARCH,
-                std::env::consts::OS
-            )
-        } else {
-            "unknown".to_string()
-        };
-        target = Some(default_target);
+        target = Some(default_target_triple());
     }
 
     let build_kind = config