[aicayzer]

Summary

The Swift SDK page and the troubleshooting guide now describe catalog.fromServer(), WorkingCopy.replaceRefused, items.addFile, and the one-time plain http notice, with what an app must declare for App Transport Security to reach a plain http server. Pairs with withmarfa/marfa-swift#369; merge after the Swift SDK release that contains it.

Changes

• Swift SDK: new sections on replacing a refused copy, reading the instance's types before the first fill and reaching a plain http server; new rows for addFile, replaceRefused and the Server notice.
• Troubleshooting and Devices: replaceRefused names the Swift call and says downloaded files stay.

Testing

• vitest run src/lib/content-lint.test.ts passes.
• The ATS statements come from Apple's pages for NSAppTransportSecurity, NSAllowsLocalNetworking and NSExceptionDomains. That the core does not use URLSession comes from its ureq HTTP client; no app was run against a plain http server.

Notes for reviewers

Merge after the Swift SDK release; the new calls do not exist before it.

Checklist

• The title is a scoped Conventional Commit.
• New behavior has a test that was seen failing first, or no test was needed and the reason is above.
• Docs, comments and the contract still say what is true after this change.

[aicayzer]

Replaced by #633, which carries this change merged with the other Swift SDK 0.0.32 pull requests into one page.