TuistPlugins: add SafeDITuist plugin for seamless Tuist integration

[dfed]

Summary

• Adds TuistPlugins/SafeDITuist — a Tuist plugin exposing two helpers (SafeDI.preCompileScript(...) and SafeDI.generatedSource) so a consuming Project.swift doesn't need to know anything about SafeDITool's binary layout, manifest schema, or build-phase invocation shape.
• Rewires Examples/ExampleTuistIntegration to consume the plugin. Project.swift drops from ~239 lines (with embedded Process glue + JSON decoder) to ~70 lines that look like idiomatic Tuist.
• Uses SafeDITool generate --combined-output (added in SafeDITool: add --combined-output flag to generate #283, shipped in 2.0.0-beta-6) so all generated Swift lands at one fixed path, $(DERIVED_FILE_DIR)/SafeDIGenerated.swift. Adding/removing @Instantiable declarations changes only the file's contents — Xcode picks them up incrementally on the next xcodebuild, no tuist generate round-trip.

Why

Per discussion on #281: a Tuist user lifting the prior example had to copy 115 lines of binary-locating + JSON-decoding scaffolding into their Project.swift. That's not Tuist-idiomatic. The plugin is the actual Tuist-native answer — adopting projects do import SafeDITuist and call helpers, full stop.

For real adoption, consumers reference the plugin via:

.git(
    url: "https://github.com/dfed/SafeDI",
    tag: "<version>",
    directory: "TuistPlugins/SafeDITuist",
)

The in-repo example uses .local(path:) for development. (Quirk: Tuist resolves .local(path:) against manifestDir/Tuist, so the path needs an extra leading .. — comment + README cover this.)

Plugin API

public enum SafeDI {
    /// Single fixed-path generated source — register once, never goes stale.
    public static let generatedSource: SourceFileGlob

    public static func preCompileScript(
        module: String,
        dependents: [String] = [],
    ) -> TargetScript
}

• preCompileScript wires SafeDITool generate --combined-output for one module. Always emits $(BUILT_PRODUCTS_DIR)/SafeDI/<module>.safedi and $(DERIVED_FILE_DIR)/SafeDIGenerated.swift. Consumers list upstream module names in dependents: to feed those .safedi artifacts through --dependent-module-info-file-path.
• generatedSource is a single static SourceFileGlob — the .generated(...) entry to add to a target's sources. Path is fixed; only its contents change.

How the example wires up

import ProjectDescription
import SafeDITuist

let project = Project(
    name: "ExampleTuistIntegration",
    targets: [
        .target(
            name: "Subproject", ...,
            sources: SourceFilesList(globs: [
                .glob("Subproject/**/*.swift"),
                SafeDI.generatedSource,
            ]),
            scripts: [SafeDI.preCompileScript(module: "Subproject")],
            dependencies: [.external(name: "SafeDI")],
        ),
        .target(
            name: "ExampleTuistIntegration", ...,
            sources: SourceFilesList(globs: [
                .glob("ExampleTuistIntegration/**/*.swift"),
                SafeDI.generatedSource,
            ]),
            scripts: [SafeDI.preCompileScript(
                module: "ExampleTuistIntegration",
                dependents: ["Subproject"],
            )],
            dependencies: [.target(name: "Subproject"), .external(name: "SafeDI")],
        ),
    ],
)

Verification

• tuist install resolves the plugin + SPM packages cleanly.
• tuist generate builds the workspace — the plugin runs no manifest-time scan, so this is fast.
• xcodebuild build succeeds — both targets emit their .safedi, host compiles SafeDIGenerated.swift.
• Seamless-rebuild verified: added generateMock: true to a previously-undecorated @Instantiable type, ran xcodebuild without re-running tuist generate, the new mock appears in SafeDIGenerated.swift and the build picks it up.
• Embedded shell verified POSIX-clean against sh/bash/dash -n parses.
• ./CLI/lint.sh clean.

Test plan

• CI's Build Tuist Integration job passes.
• Manual: @Instantiable annotation churn doesn't require tuist generate.

Notes

• Targets PR Examples: add Tuist multi-target integration example #281 — should be merged on top of that branch, or folded into it.
• Bumps the example's Tuist/Package.swift pin from 2.0.0-beta-5 to 2.0.0-beta-6 (the first release containing --combined-output).
• Drops the standalone Scripts/generate-safedi.sh; the same logic now lives inside the plugin as embedded POSIX shell.

🤖 Generated with Claude Code

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 81e12e657e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2b69b2fdfb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (682335f) to head (3d84bc9).
⚠️ Report is 1 commits behind head on claude/tuist-example-project-VXdUq.

Additional details and impacted files

@@                          Coverage Diff                          @@
##           claude/tuist-example-project-VXdUq      #288    +/-   ##
=====================================================================
  Coverage                              100.00%   100.00%            
=====================================================================
  Files                                      41        41            
  Lines                                    7043      6940   -103     
=====================================================================
- Hits                                     7043      6940   -103     

see 1 file with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: da7ebfc300

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".