docsL fix URL

build.target now holds the target triple (e.g. x86_64-unknown-linux-gnu)
build.out_dir is a custom output directory that overrides the default
target/<triple>/<profile> path.

CHANGELOG.md

@@ -1,10 +1,47 @@
 # Changelog
 
-## [0.7.0] - 2026-05-28
+## [0.7.0] - 2026-05-30
 
 Added:
 
-- **FreeBSD, OpenBSD, NetBSD, DragonflyBSD target support** — full platform routing and dynamically generated target triples.
+- **OpenBSD and NetBSD target support** — full platform routing with dynamically generated target triples using `std::env::consts::ARCH` and `std::env::consts::OS`. Affects `build`, `run`, `clean`, and the platform module.
+- **`src/platform/bsd.rs`** — new dedicated BSD platform module shared by FreeBSD, OpenBSD, NetBSD, providing `bin_path`, `lib_path`, `elf_path`, `efi_path`, and `shared_lib_path`.
+- **`build.out_dir` configuration 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()` function in `common.rs` that checks whether any object file is newer than the linked output, skipping unnecessary re-linking. Implemented for all backends (`unix_cc`, `msvc`, `gas`, `nasm`).
+- **`build.kind = "none"` and `"custom"`** — two new project kind types for special build scenarios where no standard artifact is produced.
+- **`install_bsd.sh`** — dedicated POSIX-compliant install 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 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.
+- **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.
+
+Changed:
+
+- **`build.target` semantics changed** — now strictly holds the target triple (e.g. `x86_64-unknown-linux-gnu`) or a short name (`linux`, `macos`, `windows`). No longer doubles as a custom output directory — that 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 when empty.
+- **`dcr run` with `out_dir`** — now resolves target directory respecting `build.out_dir` when configured, via `get_build_string_with_profile()` from `build.rs`.
+- **`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.
+- **Dev channel dependency check in `install.sh`** — checks for `python3` or `jq` before attempting dev channel installations.
+
+Fixed:
+
+- **`dcr run` stdout/stderr not inherited** — child process output was captured and manually printed, breaking interactive programs. Fixed by switching to `Command::status()`.
+- **Release CI race condition** — build matrix jobs could upload assets to a release that did not yet exist. Fixed by adding a dedicated `create-release` job.
+- **GHA release — stable toolchain override** — resolved Rust toolchain override issues in CI.
+- **Arch Linux package version sanitization** — version strings with dashes (e.g. `0.7.0-dev`) are invalid for Arch Linux `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 package artifact paths** — RPM artifacts placed under `rpm/x86_64/` instead of `fedora/x86_64/`. Corrected in Dexoron Packages Index workflow.
+- **`install.sh` JSON parsing robustness** — added `jq` as primary parser with `python3` fallback for dev channel release lookups.
+
+Removed:
+
+- **`format_roots()` helper** — removed from `common.rs`. Was only used by the old error path in `collect_sources()`.
+- **Individual per-distro artifact download steps** — three separate `actions/download-artifact` steps replaced with unified `gh release download --clobber`.
 
 ## [0.6.9] - 2026-05-28
 

CONTRIBUTING.md

@@ -33,7 +33,7 @@ DCR supports cross-compilation via `--target <triple>` or short names:
 - Configure multiple targets in `dcr.toml`:
 
   ```toml
-  [build.targets]
+  [build]
   targets = ["linux", "macos"]
 
   [build.linux]

README.md

@@ -33,6 +33,32 @@
 
 <table>
 <tr>
+<td><b>Linux (Dexoron Packages)</b></td>
+<td>
+
+See https://dcr.dexoron.su for settings youre packages manager
+
+**Arch Linux:**
+
+```sh
+sudo pacman -Sy dcr
+```
+
+**Debian/Ubuntu:**
+
+```sh
+sudo apt update && sudo apt install dcr
+```
+
+**Fedora/RHEL:**
+
+```sh
+sudo dnf install dcr
+```
+
+</td>
+</tr>
+<tr>
 <td><b>Arch Linux (AUR)</b></td>
 <td>
 
@@ -78,7 +104,7 @@ curl -fsSL https://dcr.dexoron.su/install.sh | bash
 <td>
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/dexoron/dcr/dev/install_bsd.sh | bash
+curl -fsSL https://dcr.dexoron.su/install_bsd.sh | bash
 ```
 
 </td>
@@ -152,15 +178,21 @@ kind = "bin"
 |---|---|
 | `dcr new <name>` | Create a new project |
 | `dcr init` | Initialize current directory |
+| `dcr add <dep>` | Add a dependency |
 | `dcr build [--release]` | Build the project |
 | `dcr run [--release]` | Build and run |
 | `dcr clean` | Remove build artifacts |
+| `dcr test` | Run project tests |
+| `dcr fmt` | Format C/C++ sources (clang-format) |
+| `dcr tree` | View dependency tree |
+| `dcr gen <vscode\|clion\|compile-commands>` | Generate IDE integration |
+| `dcr setup` | Initialize DCR registry |
 
 other in [docs/](docs/) and `dcr --help`
 
 ---
 
-## Platforms
+## Platforms(pre-build source)
 
 <div align="center">
 
@@ -169,9 +201,9 @@ other in [docs/](docs/) and `dcr --help`
 | Linux   | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ |
 | macOS   | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
 | Windows | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ |
-| FreeBSD | ✅ | ⚠️ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| OpenBSD | ✅ | ⚠️ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
-| NetBSD  | ✅ | ⚠️ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
+| FreeBSD | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
+| OpenBSD | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
+| NetBSD  | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
 
 ✅ officially supported · ⚠️ community / best-effort · ❌ not supported
 

docs/SUMMARY.md

@@ -27,6 +27,7 @@
 * [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

docs/commands/dcr-build.md

@@ -30,9 +30,12 @@ dcr build --debug --clean
 - `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`
@@ -58,8 +61,9 @@ dcr build --debug --clean
 
 - 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`).
+- `--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.

docs/commands/dcr-fmt.md

@@ -0,0 +1,19 @@
+# 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-run.md

@@ -23,11 +23,12 @@ dcr run --debug --clean
 
 ## Restrictions
 
-- If `build.kind` (or `build.{profile}.kind`) is `"staticlib"` or `"sharedlib"`, `run` exits with error.
+- 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`).
+- `--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
 

docs/configuration/build-profiles.md

@@ -30,10 +30,13 @@ You can also add `--force` or `--clean` to `build`/`run`.
 
 ## Artifacts
 
-By default:
+By default (for `kind = "bin"`):
 
-- `target/debug/<name>` (or `.exe` on Windows)
-- `target/release/<name>` (or `.exe` on Windows)
+- `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:
 
@@ -58,6 +61,14 @@ Shared library mode (`kind = "sharedlib"`):
 - 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.

docs/configuration/build-section.md

@@ -13,7 +13,8 @@ kind = "bin"
 # optional:
 # inherit = true  # Inherit from base (default true)
 # targets = ["linux", "macos"]  # Multiple targets to build
-# target = "./dist"
+# out_dir = "./dist"
+# target = "x86_64-unknown-linux-gnu"
 # platform = "x86_64"
 # cflags = ["-Wall"]
 # ldflags = ["-lm"]
@@ -31,17 +32,17 @@ kind = "bin"
 
 - `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, required): C language standard passed to compiler (e.g. `c11`, `c17`, `gnu11`).
+- `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, required): `bin`, `staticlib`, `sharedlib`, `efi`, or `elf`.
+- `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): custom output directory for final artifact.
-  When set, DCR automatically injects `--target=<value>` into `cflags` (useful for clang cross-compilation).
+- `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.

docs/configuration/dcr.toml-overview.md

@@ -35,17 +35,16 @@ Workspace-only root:
 - `package.name`
 - `package.version`
 - `build.language`
-- `build.standard`
 - `build.compiler`
-- `build.kind`
-
-`build.kind` must be either `bin`, `staticlib`, or `sharedlib`.
 
 ## 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`

docs/configuration/dependencies-section.md

@@ -18,6 +18,8 @@ frecli = { path = "./lib/frecli", include = ["."], lib = ["."], libs = ["frecli"
 
 ### 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.

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

@@ -23,6 +23,9 @@ dcr run --target linux --release
 - `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:
@@ -32,6 +35,9 @@ DCR supports any valid target triple in the format `<arch>-<vendor>-<os>-<abi>`.
 - `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
 
@@ -40,11 +46,11 @@ DCR supports any valid target triple in the format `<arch>-<vendor>-<os>-<abi>`.
 Configure multiple targets to build simultaneously:
 
 ```toml
-[build.targets]
+[build]
 targets = ["linux", "macos", "windows"]
 
 # Or per profile
-[build.release.targets]
+[build.release]
 targets = ["linux", "macos"]
 ```
 
@@ -66,6 +72,10 @@ 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
@@ -99,6 +109,9 @@ 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
@@ -151,7 +164,10 @@ target/
 ├── x86_64-unknown-linux-gnu/
 │   ├── debug/
 │   └── release/
-└── aarch64-linux-gnu/
+├── aarch64-linux-gnu/
+│   ├── debug/
+│   └── release/
+└── x86_64-unknown-freebsd/
     ├── debug/
     └── release/
 ```
@@ -200,4 +216,4 @@ dcr build --target windows --release
 - **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](troubleshooting-map.md).
+For more help, see [Troubleshooting map](../reference-and-help/troubleshooting-map.md).

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

@@ -26,6 +26,8 @@ json = { git = "https://github.com/nlohmann/json", tag = "v3.11.2" }
 - `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
 
@@ -35,6 +37,8 @@ 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/target-directory.md

@@ -2,22 +2,29 @@
 
 By default, DCR writes final artifacts to `target/<target>/<profile>/` (where `<target>` is `native` or target triple).
 
-You can override this with `build.target`:
+You can override this with `build.out_dir`:
 
 ```toml
 [build]
-target = "./dist"
+out_dir = "./dist"
 ```
 
 ## Behavior
 
 - Binary mode:
-  - Linux/macOS: `<target>/<name>`
-  - Windows: `<target>/<name>.exe`
+  - Linux/macOS: `<out_dir>/<name>`
+  - Windows: `<out_dir>/<name>.exe`
 - Static library mode:
-  - Linux/macOS: `<target>/lib<name>.a`
-  - Windows: `<target>/<name>.lib`
+  - Linux/macOS: `<out_dir>/lib<name>.a`
+  - Windows: `<out_dir>/<name>.lib`
 
 ## Important detail
 
-`build.target` changes only the final artifact location. Object cache and dependency sync directories still use `target/<target>/<profile>/...`.
+`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/getting-started/project-structure.md

@@ -37,4 +37,4 @@ project/
 - `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.target` is set, the final artifact is written to that custom directory, while object cache still stays in `target/<target>/<profile>/obj`.
+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/reference-and-help/cli-reference.md

@@ -13,6 +13,8 @@ dcr clean [--debug|--release] [--all]
 dcr tree
 dcr test
 dcr gen <subcommand>
+dcr fmt
+dcr setup
 dcr --help
 dcr --version
 dcr --update
@@ -20,11 +22,13 @@ dcr --update
 
 ## Notes on argument parsing
 
-- `build`/`run` parse flags in any order (`--debug|--release`, `--force`, `--clean`, `--verbose`) and reject duplicates.
+- `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.
 

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

@@ -19,13 +19,14 @@ categories  = ["string", "..."]   # optional
 
 [build]
 language     = "c|c++|cpp|cxx|asm"               # required (string or array)
-standard     = "string"                          # required (e.g. "c11", "gnu11")
+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" # required
+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)
-type         = "string"                          # optional
+
 cflags       = ["string", "..."]                 # optional (supports {version} etc.)
 ldflags      = ["string", "..."]                 # optional (supports {version} etc.)
 ldscript     = "string"                          # optional (linker script path)
@@ -121,14 +122,15 @@ rev     = "string"          # optional (git commit)
 include = ["string", "..."] # optional (include dirs)
 lib     = ["string", "..."] # optional (lib dirs)
 libs    = ["string", "..."] # optional (link libs)
-features = ["string", "..."] # optional (registry features)
+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`, or `elf`.
+- `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.

docs/reference-and-help/faq.md

@@ -2,7 +2,7 @@
 
 ## What commands are available?
 
-`new`, `init`, `build`, `run`, `clean`, `gen`, `--help`, `--version`, `--update`.
+`new`, `init`, `add`, `build`, `run`, `clean`, `test`, `fmt`, `tree`, `gen`, `setup`, `--help`, `--version`, `--update`.
 
 ## Is `dcr.toml` mandatory?
 

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

@@ -8,8 +8,11 @@ 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:
 

scripts/sync-releases-to-gitlab.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""Sync all GitHub Releases (with assets) to GitLab Releases."""
+
+import json
+import os
+import sys
+import time
+import urllib.error
+import urllib.request
+import uuid
+
+GL_TOKEN = os.environ.get("GL_TOKEN")
+if not GL_TOKEN:
+    print("FATAL: GL_TOKEN environment variable not set", file=sys.stderr)
+    sys.exit(1)
+
+GL_PROJECT = "dexoron-studio%2Fdcr"
+GL_PROJECT_RAW = "dexoron-studio/dcr"
+GL_API = "https://gitlab.com/api/v4"
+GH_REPO = "dexoron/dcr"
+
+
+def gl_api(method, path, data=None, filepath=None, retries=5):
+    url = f"{GL_API}/{path}"
+    headers = {"PRIVATE-TOKEN": GL_TOKEN}
+
+    if data is not None and filepath is None:
+        headers["Content-Type"] = "application/json"
+        body = json.dumps(data).encode()
+    elif filepath:
+        boundary = uuid.uuid4().hex
+        with open(filepath, "rb") as f:
+            fdata = f.read()
+        fname = os.path.basename(filepath)
+        parts = []
+        parts.append(f"--{boundary}".encode())
+        parts.append(f'Content-Disposition: form-data; name="file"; filename="{fname}"'.encode())
+        parts.append(b"Content-Type: application/octet-stream")
+        parts.append(b"")
+        parts.append(fdata)
+        parts.append(f"--{boundary}--".encode())
+        parts.append(b"")
+        body = b"\r\n".join(parts)
+        headers["Content-Type"] = f"multipart/form-data; boundary={boundary}"
+    else:
+        body = None
+
+    for attempt in range(retries):
+        try:
+            req = urllib.request.Request(url, data=body, headers=headers, method=method)
+            with urllib.request.urlopen(req) as resp:
+                text = resp.read().decode()
+                return json.loads(text) if text else None
+        except urllib.error.HTTPError as e:
+            body_text = e.read().decode() if e.fp else ""
+            if e.code in (409, 429) and attempt < retries - 1:
+                time.sleep(3)
+                continue
+            if attempt < retries - 1:
+                time.sleep(1)
+                continue
+            print(f"  HTTP {e.code}: {body_text[:300]}", file=sys.stderr)
+            return None
+        except Exception as e:
+            if attempt < retries - 1:
+                time.sleep(1)
+                continue
+            print(f"  Error: {e}", file=sys.stderr)
+            return None
+    return None
+
+
+def download_file(url, dest):
+    with urllib.request.urlopen(url) as resp:
+        with open(dest, "wb") as f:
+            f.write(resp.read())
+
+
+# --- MAIN ---
+print("Fetching GitHub releases...")
+with urllib.request.urlopen(f"https://api.github.com/repos/{GH_REPO}/releases?per_page=50") as r:
+    gh_releases = json.loads(r.read().decode())
+
+print(f"Found {len(gh_releases)} releases on GitHub")
+
+# Reverse to process oldest first (GitHub returns newest first)
+gh_releases.reverse()
+
+print("Fetching existing GitLab releases and their assets...")
+existing = gl_api("GET", f"projects/{GL_PROJECT}/releases?per_page=100") or []
+existing = existing if isinstance(existing, list) else []
+
+# Build map: tag -> set of existing asset names
+gl_assets = {}
+for rel in existing:
+    tag = rel["tag_name"]
+    links = rel.get("assets", {}).get("links", []) or rel.get("assets", {}).get("sources", []) or []
+    gl_assets[tag] = {l.get("name", "") for l in links if isinstance(l, dict)}
+    # Also get the release description to check if it needs updating
+    gl_assets[tag + "__desc"] = rel.get("description", "")
+
+print(f"Existing GitLab releases: {len(existing)}")
+
+download_dir = "/tmp/gh-assets"
+os.makedirs(download_dir, exist_ok=True)
+
+# Reverse: process older first so newer releases with many assets get their description too
+# Actually, process in original order
+total = len(gh_releases)
+for i, rel in enumerate(gh_releases):
+    tag = rel["tag_name"]
+    body = rel.get("body", "") or ""
+    assets = rel.get("assets", [])
+    if isinstance(assets, dict):
+        assets = assets.get("nodes", []) or []
+
+    print(f"\n{'='*60}")
+    print(f"[{i+1}/{total}] {tag} ({len(assets)} assets)")
+
+    # Create or update release
+    existing_tag = tag in gl_assets
+    if not existing_tag:
+        print(f"  Creating release...")
+        result = gl_api("POST", f"projects/{GL_PROJECT}/releases", data={
+            "tag_name": tag,
+            "name": rel.get("name", tag),
+            "description": body,
+            "ref": "master",
+        })
+        if result is None:
+            print(f"  FAILED — skip")
+            continue
+        print(f"  OK")
+    else:
+        # Update description if needed
+        existing_desc = gl_assets.get(tag + "__desc", "")
+        if body and body != existing_desc:
+            print(f"  Updating description...")
+            gl_api("PUT", f"projects/{GL_PROJECT}/releases/{urllib.request.quote(tag, safe='')}",
+                   data={"description": body})
+
+    existing_links = gl_assets.get(tag, set())
+
+    for j, asset in enumerate(assets):
+        aname = asset.get("name", "")
+        aurl = asset.get("browser_download_url", "")
+        if not aurl:
+            continue
+
+        if aname in existing_links:
+            print(f"  [{j+1}/{len(assets)}] {aname} — already exists")
+            continue
+
+        fpath = os.path.join(download_dir, aname)
+        print(f"  [{j+1}/{len(assets)}] {aname}...", end=" ", flush=True)
+
+        # Download from GitHub
+        try:
+            download_file(aurl, fpath)
+        except Exception as e:
+            print(f"download failed: {e}")
+            continue
+
+        # Upload to GitLab
+        up = gl_api("POST", f"projects/{GL_PROJECT}/uploads", filepath=fpath)
+        if not up or "url" not in up:
+            size_mb = os.path.getsize(fpath) / (1024 * 1024)
+            print(f"upload failed ({size_mb:.1f} MB)")
+            os.remove(fpath)
+            continue
+
+        file_url = up["url"]
+        full_url = f"https://gitlab.com/{GL_PROJECT_RAW}{file_url}"
+
+        # Link asset to release
+        encoded_tag = urllib.request.quote(tag, safe='')
+        link = gl_api("POST",
+            f"projects/{GL_PROJECT}/releases/{encoded_tag}/assets/links",
+            data={"name": aname, "url": full_url},
+            retries=5)
+        if link:
+            print(f"linked")
+            existing_links.add(aname)
+        else:
+            print(f"link failed")
+
+        os.remove(fpath)
+
+    time.sleep(0.3)
+
+print(f"\n{'='*60}")
+print("Done!")

src/cli/build.rs

@@ -211,7 +211,7 @@ fn get_string_with_profile_and_target(
     }
 }
 
-fn get_build_string_with_profile(config: &Config, field: &str, profile: &str) -> String {
+pub fn get_build_string_with_profile(config: &Config, field: &str, profile: &str) -> String {
     get_string_with_profile_and_target(config, field, profile, None)
 }
 
@@ -712,26 +712,31 @@ fn build_project_at(
         let resolved_linker = resolve_tool("DCR_LD", tc_ld.as_deref());
         let resolved_archiver = resolve_tool("DCR_AR", tc_ar.as_deref());
 
-        let target_dir_binding = match workspace_root {
-            Some(root) => {
-                let target_str = build_target
-                    .map(normalize_target_os)
-                    .filter(|t| !t.is_empty());
-                let rel: PathBuf = match target_str {
-                    Some(ref t) => Path::new("target").join(t).join(profile),
-                    None => {
-                        let default_dir = if cfg!(target_os = "linux") {
-                            let arch = std::env::consts::ARCH;
-                            format!("{arch}-unknown-linux-gnu/{profile}")
-                        } else {
-                            profile.to_string()
-                        };
-                        Path::new("target").join(&default_dir)
-                    }
-                };
-                root.join(&rel).to_string_lossy().to_string()
+        let out_dir_config = get_build_string_with_profile(&config, "out_dir", profile);
+        let target_dir_binding = if !out_dir_config.is_empty() {
+            out_dir_config
+        } else {
+            match workspace_root {
+                Some(root) => {
+                    let target_str = build_target
+                        .map(normalize_target_os)
+                        .filter(|t| !t.is_empty());
+                    let rel: PathBuf = match target_str {
+                        Some(ref t) => Path::new("target").join(t).join(profile),
+                        None => {
+                            let default_dir = if cfg!(target_os = "linux") {
+                                let arch = std::env::consts::ARCH;
+                                format!("{arch}-unknown-linux-gnu/{profile}")
+                            } else {
+                                profile.to_string()
+                            };
+                            Path::new("target").join(&default_dir)
+                        }
+                    };
+                    root.join(&rel).to_string_lossy().to_string()
+                }
+                None => normalize_target(build_target.unwrap_or(""), profile).unwrap_or_default(),
             }
-            None => normalize_target(build_target.unwrap_or(""), profile).unwrap_or_default(),
         };
         let target_dir = if target_dir_binding.is_empty() {
             None

src/cli/fmt.rs

@@ -1,3 +1,20 @@
+// DCR — Cargo-like C/C++ project manager.
+//
+// Copyright (C) 2026 Dexoron (Bezotechestvo Vladimir) <main@dexoron.su>
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// 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 glob::glob;
@@ -7,12 +24,20 @@ pub fn fmt(_args: &[String]) -> i32 {
     let patterns = [
         "src/**/*.c",
         "src/**/*.cpp",
+        "src/**/*.cxx",
+        "src/**/*.cc",
         "src/**/*.h",
         "src/**/*.hpp",
+        "src/**/*.hxx",
+        "src/**/*.hh",
         "tests/**/*.c",
         "tests/**/*.cpp",
+        "tests/**/*.cxx",
+        "tests/**/*.cc",
         "tests/**/*.h",
         "tests/**/*.hpp",
+        "tests/**/*.hxx",
+        "tests/**/*.hh",
     ];
 
     let mut files = Vec::new();

src/cli/run.rs

@@ -83,7 +83,6 @@ pub fn run(args: &[String]) -> i32 {
             return 1;
         }
     };
-
     let flags = match parse_build_run_flags(args) {
         Ok(v) => v,
         Err(_) => return 1,
@@ -188,14 +187,20 @@ fn run_project(
         .or_else(|| config.get("build.kind").and_then(|v| v.as_str()))
         .unwrap_or("");
 
-    let normalized_target_dir = match workspace_root {
-        Some(wr) => target
-            .as_ref()
-            .and_then(|t| crate::cli::build::normalize_target(t, &flags.profile))
-            .map(|rel| wr.join(&rel).to_string_lossy().to_string()),
-        None => target
-            .as_ref()
-            .and_then(|t| crate::cli::build::normalize_target(t, &flags.profile)),
+    let out_dir =
+        crate::cli::build::get_build_string_with_profile(&config, "out_dir", &flags.profile);
+    let normalized_target_dir = if !out_dir.is_empty() {
+        Some(out_dir)
+    } else {
+        match workspace_root {
+            Some(wr) => target
+                .as_ref()
+                .and_then(|t| crate::cli::build::normalize_target(t, &flags.profile))
+                .map(|rel| wr.join(&rel).to_string_lossy().to_string()),
+            None => target
+                .as_ref()
+                .and_then(|t| crate::cli::build::normalize_target(t, &flags.profile)),
+        }
     };
 
     let version = config

src/core/config.rs

@@ -119,6 +119,8 @@ pub struct BuildConfig {
     #[serde(default)]
     pub target: Option<String>,
     #[serde(default)]
+    pub out_dir: Option<String>,
+    #[serde(default)]
     pub platform: Option<String>,
     #[serde(default)]
     pub cflags: Vec<String>,
@@ -396,6 +398,9 @@ impl Config {
         if let Some(target) = &build.target {
             validate_non_empty_string(target, "build.target")?;
         }
+        if let Some(out_dir) = &build.out_dir {
+            validate_non_empty_string(out_dir, "build.out_dir")?;
+        }
         for profile in ["release", "debug"] {
             if let Some(section) = self
                 .data
@@ -539,7 +544,9 @@ impl Config {
         if let Some(lang) = table.get("language") {
             self.validate_language(lang)?;
         }
-        for key in ["standard", "compiler", "kind", "target", "platform"] {
+        for key in [
+            "standard", "compiler", "kind", "target", "out_dir", "platform",
+        ] {
             if let Some(value) = table.get(key) {
                 let s = value.as_str().unwrap_or("");
                 if s.trim().is_empty() {
@@ -784,6 +791,11 @@ fn format_toml(value: &Value) -> Result<String, ConfigError> {
     {
         out.push_str(&format!("target = \"{target}\"\n"));
     }
+    if let Some(out_dir) = build.get("out_dir").and_then(|v| v.as_str())
+        && !out_dir.trim().is_empty()
+    {
+        out.push_str(&format!("out_dir = \"{out_dir}\"\n"));
+    }
     if let Some(cflags) = build.get("cflags") {
         out.push_str(&format!("cflags = {}\n", format_string_array(cflags)));
     }

src/platform/bsd.rs

@@ -1,3 +1,20 @@
+// DCR — Cargo-like C/C++ project manager.
+//
+// Copyright (C) 2026 Dexoron (Bezotechestvo Vladimir) <main@dexoron.su>
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
 pub fn bin_path(profile: &str, name: &str, target_dir: Option<&str>) -> String {
     match target_dir {
         Some(dir) => format!("{}/{}", dir.trim_end_matches('/'), name),

tests/cli_basic.rs

@@ -383,6 +383,96 @@ fn registry_dependency_is_built_from_cache() {
     );
 }
 
+fn parse_project_name(toml: &str) -> String {
+    toml.lines()
+        .find(|l| l.trim().starts_with("name ="))
+        .and_then(|l| l.split('=').nth(1))
+        .map(|s| s.trim().trim_matches('"').to_string())
+        .expect("could not parse project name from dcr.toml")
+}
+
+fn default_artifact_path(project_root: &Path, project_name: &str) -> PathBuf {
+    project_root
+        .join("target")
+        .join("x86_64-unknown-linux-gnu")
+        .join("debug")
+        .join(project_name)
+}
+
+#[test]
+fn build_with_target_config() {
+    let Some(compiler) = available_compiler() else {
+        eprintln!("no compiler found; skipping target config test");
+        return;
+    };
+
+    let dir = unique_sandbox_dir("target_cfg");
+    let out = run_dcr(&["init"], &dir);
+    assert!(out.status.success(), "dcr init should succeed");
+
+    let toml_path = dir.join("dcr.toml");
+    let toml = std::fs::read_to_string(&toml_path).expect("failed to read dcr.toml");
+    let project_name = parse_project_name(&toml);
+    let updated = toml.replace("[build]", "[build]\ntarget = \"linux\"");
+    std::fs::write(&toml_path, updated).expect("failed to write dcr.toml");
+
+    let envs = [("DCR_COMPILER", compiler)];
+    let out = run_dcr_env(&["build"], &dir, &envs);
+    assert!(
+        out.status.success(),
+        "dcr build with target = \"linux\" should succeed"
+    );
+
+    let artifact = default_artifact_path(&dir, &project_name);
+    assert!(
+        artifact.is_file(),
+        "artifact should be at default path target/x86_64-unknown-linux-gnu/debug/{}",
+        project_name
+    );
+}
+
+#[test]
+fn build_with_out_dir() {
+    let Some(compiler) = available_compiler() else {
+        eprintln!("no compiler found; skipping out_dir test");
+        return;
+    };
+
+    let dir = unique_sandbox_dir("out_dir");
+    let out = run_dcr(&["init"], &dir);
+    assert!(out.status.success(), "dcr init should succeed");
+
+    let toml_path = dir.join("dcr.toml");
+    let toml = std::fs::read_to_string(&toml_path).expect("failed to read dcr.toml");
+    let project_name = parse_project_name(&toml);
+    let updated = toml.replace("[build]", "[build]\nout_dir = \"./_BUILD\"");
+    std::fs::write(&toml_path, updated).expect("failed to write dcr.toml");
+
+    let envs = [("DCR_COMPILER", compiler)];
+    let out = run_dcr_env(&["build"], &dir, &envs);
+    if !out.status.success() {
+        eprintln!("stdout: {}", String::from_utf8_lossy(&out.stdout));
+        eprintln!("stderr: {}", String::from_utf8_lossy(&out.stderr));
+    }
+    assert!(
+        out.status.success(),
+        "dcr build with out_dir should succeed"
+    );
+
+    let artifact = dir.join("_BUILD").join(&project_name);
+    assert!(
+        artifact.is_file(),
+        "artifact should be at _BUILD/{} (custom out_dir)",
+        project_name
+    );
+
+    let default_path = default_artifact_path(&dir, &project_name);
+    assert!(
+        !default_path.exists(),
+        "artifact should NOT be at default path when out_dir is set"
+    );
+}
+
 #[test]
 fn dcr_test_runs_without_sandbox_dependency() {
     let Some(compiler) = available_compiler() else {