refactor: extract SDK into packages/sdk/ workspace package

- Create packages/sdk/ (torrust-tracker-deployer-sdk) with SDK source
- Copy builder.rs, deployer.rs, error.rs from src/presentation/sdk/
  and update imports: crate:: → torrust_tracker_deployer_lib::
- Create packages/sdk/src/lib.rs with full public API re-exports
- Move examples/sdk/ → packages/sdk/examples/ and update imports
- Remove SDK [[example]] entries from root Cargo.toml
- Add packages/sdk to workspace members
- Add packages/sdk/README.md
- Update .github/workflows/test-sdk-examples.yml to use -p flag
- Update packages/README.md with SDK package entry
- Update docs/codebase-architecture.md with Workspace Packages section
- Note: root→SDK backward compat re-export deferred (cyclic dep);
  src/presentation/sdk/ kept intact until Plan 3 extracts shared types

Author: josecelano

.github/workflows/test-sdk-examples.yml

@@ -56,24 +56,24 @@ jobs:
 
       - name: Build SDK examples
         run: |
-          cargo build --examples
+          cargo build --examples -p torrust-tracker-deployer-sdk
 
       - name: Run SDK examples
         run: |
           echo "🚀 Running SDK basic usage example at $(date)"
-          cargo run --example sdk_basic_usage
+          cargo run --example sdk_basic_usage -p torrust-tracker-deployer-sdk
           echo "✅ SDK basic usage example completed at $(date)"
 
           echo "🚀 Running SDK error handling example at $(date)"
-          cargo run --example sdk_error_handling
+          cargo run --example sdk_error_handling -p torrust-tracker-deployer-sdk
           echo "✅ SDK error handling example completed at $(date)"
 
           echo "🚀 Running SDK create-from-JSON-file example at $(date)"
-          cargo run --example sdk_create_from_json_file
+          cargo run --example sdk_create_from_json_file -p torrust-tracker-deployer-sdk
           echo "✅ SDK create-from-JSON-file example completed at $(date)"
 
           echo "🚀 Running SDK validate-config example at $(date)"
-          cargo run --example sdk_validate_config
+          cargo run --example sdk_validate_config -p torrust-tracker-deployer-sdk
           echo "✅ SDK validate-config example completed at $(date)"
 
       - name: Debug information (on failure)

Cargo.toml

@@ -2,6 +2,7 @@
 members = [
   "packages/linting",
   "packages/dependency-installer",
+  "packages/sdk",
 ]
 resolver = "2"
 
@@ -40,26 +41,6 @@ path = "src/bin/linter.rs"
 name = "test_logging"
 path = "src/bin/test_logging.rs"
 
-[[example]]
-name = "sdk_basic_usage"
-path = "examples/sdk/basic_usage.rs"
-
-[[example]]
-name = "sdk_full_deployment"
-path = "examples/sdk/full_deployment.rs"
-
-[[example]]
-name = "sdk_error_handling"
-path = "examples/sdk/error_handling.rs"
-
-[[example]]
-name = "sdk_create_from_json_file"
-path = "examples/sdk/create_from_json_file.rs"
-
-[[example]]
-name = "sdk_validate_config"
-path = "examples/sdk/validate_config.rs"
-
 [dependencies]
 tokio = { version = "1.0", features = [ "full" ] }
 anyhow = "1.0"

docs/codebase-architecture.md

@@ -213,6 +213,14 @@ Application initialization and lifecycle management:
 - ✅ `src/bin/e2e-infrastructure-lifecycle-tests.rs` - E2E infrastructure lifecycle tests
 - ✅ `src/bin/e2e-complete-workflow-tests.rs` - Complete E2E workflow test suite
 
+### Workspace Packages
+
+Independently versioned Cargo workspace packages in `packages/`:
+
+- ✅ `packages/linting/` - Unified linting framework (runs markdownlint, yamllint, taplo, cspell, clippy, rustfmt, shellcheck)
+- ✅ `packages/dependency-installer/` - Dependency detection and installation for development setup (OpenTofu, Ansible, LXD, cargo-machete)
+- ✅ `packages/sdk/` - Programmatic SDK (`torrust-tracker-deployer-sdk`) — independently consumable Rust crate for deploying Torrust Tracker instances without the CLI
+
 ### Presentation Layer
 
 **CLI Interface and User Interaction:**
@@ -232,6 +240,14 @@ Application initialization and lifecycle management:
 - ✅ `src/presentation/views/` - User output formatting and message rendering
 - ✅ `src/presentation/errors.rs` - Unified error types with tiered help system
 
+**SDK Interface (Programmatic API):**
+
+- ✅ `src/presentation/sdk/mod.rs` - SDK module root with re-exports (kept for backward compatibility)
+- ✅ `src/presentation/sdk/builder.rs` - `DeployerBuilder` typed configuration builder
+- ✅ `src/presentation/sdk/deployer.rs` - `Deployer` facade (main SDK entry point)
+- ✅ `src/presentation/sdk/error.rs` - SDK-specific error types
+- → See `packages/sdk/` for the independently consumable SDK workspace package
+
 ### Domain Layer
 
 **Core Domain Entities:**

docs/refactors/active-refactorings.md

@@ -3,7 +3,6 @@
 | Document                                                                                              | Status      | Issue                                                                  | Target                                    | Created    |
 | ----------------------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------- | ----------------------------------------- | ---------- |
 | [E2E Test Isolation - Complete Log Directory Support](plans/e2e-test-isolation-log-dir.md)            | 📋 Planning | [#365](https://github.com/torrust/torrust-tracker-deployer/issues/365) | Add log_dir to all E2E tests              | 2026-02-18 |
-| [Extract SDK Workspace Package](plans/extract-sdk-workspace-package.md)                               | 📋 Planning | TBD                                                                    | Move SDK into packages/sdk/               | 2026-02-24 |
 | [Extract Shared Types Package](plans/extract-shared-types-package.md)                                 | 📋 Planning | TBD                                                                    | Shared value objects for SDK consumers    | 2026-02-24 |
 | [SDK DDD Layer Boundary Fixes](plans/sdk-ddd-layer-boundary-fixes.md)                                 | 📋 Planning | TBD                                                                    | Remove DDD violations from SDK surface    | 2026-02-24 |
 | [Separate View Data from Views](plans/separate-view-data-from-views.md)                               | 📋 Planning | TBD                                                                    | Organize presentation layer command views | 2026-02-16 |

docs/refactors/completed-refactorings.md

@@ -2,6 +2,7 @@
 
 | Document                                    | Completed    | Target                                                                 | Notes                                                                                                                                                                                                                                                                                       |
 | ------------------------------------------- | ------------ | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Extract SDK Workspace Package               | Feb 25, 2026 | Create packages/sdk/ as independently consumable workspace package     | See git history at `docs/refactors/plans/extract-sdk-workspace-package.md` - Created `packages/sdk/` (`torrust-tracker-deployer-sdk`) with SDK source, README, and examples moved from root `examples/sdk/`; backward compat deferred (cyclic dep resolved in Plan 3), PR #381              |
 | Presentation CLI/SDK Separation             | Feb 25, 2026 | Separate CLI and SDK in presentation layer                             | See git history at `docs/refactors/plans/presentation-cli-sdk-separation.md` - Moved all CLI-specific modules (controllers, dispatch, input, views, error, errors, tests) under `src/presentation/cli/`, updated 160 files, SDK confirmed zero CLI imports (commit f02024f6, PR #381)       |
 | Extract Template Rendering Services         | Feb 10, 2026 | Eliminate rendering duplication                                        | See git history at `docs/refactors/plans/extract-template-rendering-services.md` - Extracted template rendering logic into shared application-layer services for all 8 template types, eliminating duplication between render command and Steps (5 phases completed, final commit 463e7933) |
 | Split tracker_ports.rs into Submodule       | Feb 6, 2026  | Split 562-line file into focused submodule                             | See git history at `docs/refactors/plans/split-tracker-ports-into-submodule.md` - Refactored monolithic file into tracker_container_setup/ submodule with 5 focused files (container_ports, tracker_ports, config, runtime, mod), PR #319                                                   |