feat: add --write flag to sample script and update docs

Support full end-to-end testing via ./run-sample.sh --write. Update
README with write mode usage and reset instructions.

Author: kaanbiryol

README.md

@@ -39,14 +39,30 @@ make build
 
 ## Try it out
 
-A sample project is included to test the tool end-to-end without needing a real Xcode workspace or Tuist:
+A sample project is included to test the tool without needing a real Xcode workspace or Tuist:
 
 ```bash
 cd SampleProject
+
+# Preview the generated interface (dry run, no files written)
 ./run-sample.sh
+
+# Run the full pipeline (creates interface module, rewrites Project.swift and imports)
+./run-sample.sh --write
 ```
 
-This builds the tool, compiles a sample Swift module via SPM, extracts compiler arguments, and runs the tool with `--print-only` to display the generated interface.
+The script builds the tool, compiles a sample Swift module via SPM, extracts compiler arguments, and runs the tool. Use `--write` to execute the full pipeline, or omit it to preview with `--print-only`.
+
+After running with `--write`, you'll see:
+- `libraries/business/UserProfileInterface/` created with `Sources/` and `TestSupport/`
+- `Project.swift` updated with the new interface module declaration
+
+To reset the sample project after a full run:
+
+```bash
+git checkout SampleProject/Project.swift
+rm -rf SampleProject/libraries/business/UserProfileInterface
+```
 
 ## Usage
 

SampleProject/run-sample.sh

@@ -6,6 +6,13 @@ REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 MODULE_NAME="UserProfile"
 PACKAGE_DIR="$SCRIPT_DIR/libraries/business/UserProfile"
 
+PRINT_ONLY="--print-only"
+if [ "${1:-}" = "--write" ]; then
+    PRINT_ONLY=""
+    echo "Running in WRITE mode - files will be created and modified."
+    echo ""
+fi
+
 echo "=== Step 1: Build the generateInterface tool ==="
 cd "$REPO_ROOT"
 swift build -c debug 2>&1 | tail -1
@@ -50,7 +57,7 @@ echo "Compiler arguments written to: $ARGS_FILE"
 echo "$(wc -l < "$ARGS_FILE" | tr -d ' ') arguments extracted."
 
 echo ""
-echo "=== Step 4: Run generateInterface with --print-only ==="
+echo "=== Step 4: Run generateInterface${PRINT_ONLY:+ (dry run)} ==="
 
 # SourceKit requires the Xcode toolchain frameworks to be in the dynamic library path
 TOOLCHAIN_LIB="$(xcode-select -p)/Toolchains/XcodeDefault.xctoolchain/usr/lib"
@@ -61,7 +68,7 @@ export DYLD_FRAMEWORK_PATH="$TOOLCHAIN_LIB:${DYLD_FRAMEWORK_PATH:-}"
     "$MODULE_NAME" \
     "$SCRIPT_DIR/libraries" \
     "$ARGS_FILE" \
-    --print-only
+    $PRINT_ONLY
 
 # Clean up
 rm -f "$ARGS_FILE"