Merge pull request #1 from Jibbscript/codex/unsigned-native-host-gui-install

Add GUI install guidance for unsigned native host

Author: Jibbscript

README.md

@@ -15,6 +15,12 @@ Each public release may attach only:
 
 The internal native-host handoff tarball is intentionally not a public release asset.
 
+## macOS Early Access Install
+
+Unsigned macOS Apple Silicon native-host releases use Finder and Installer.app. If macOS blocks the package, follow the Privacy & Security exception flow in the canonical guide:
+
+- [Unsigned Native Host Install Guide](docs/unsigned-native-host-install.md)
+
 ## Repository Policy
 
 Tracked files in this repository are limited to public metadata and policy files. Do not commit product source code, build outputs, packaged binaries, signing materials, private provenance, workspace dumps, or source-bearing archives.

docs/unsigned-native-host-install.md

@@ -0,0 +1,54 @@
+# Unsigned Native Host Install Guide
+
+This guide is for Early Access macOS Apple Silicon releases that attach a file named like:
+
+`PrivacyGuard-native-host-X.Y.Z-macos-arm64-unsigned.pkg`
+
+The package contains an ad-hoc signed native-host binary and is not Apple notarized. macOS may block it until you approve an exception in Privacy & Security. Use the notarized package instead whenever the release provides one without `-unsigned` in the filename.
+
+## Install Without Command Line
+
+1. Open the RedactPIITool public release page:
+   <https://github.com/Jibbscript/redactpiitools-release/releases/latest>
+2. In the release Assets section, download `PrivacyGuard-native-host-X.Y.Z-macos-arm64-unsigned.pkg`.
+3. Double-click the downloaded `.pkg` file in Finder.
+4. If Installer.app opens, follow the prompts and enter your macOS administrator password if asked.
+5. If macOS blocks the package:
+   - Close the warning.
+   - Open System Settings.
+   - Go to Privacy & Security.
+   - Click Open Anyway for the PrivacyGuard package.
+   - Confirm Open when macOS asks.
+   - Follow the Installer.app prompts.
+6. Restart Chrome after the installer completes.
+
+## Install The Chrome Extension
+
+Install the Chrome extension from the Chrome Web Store:
+
+<https://chromewebstore.google.com/detail/privacyguard/ncmfgfeipmcjibfmeglbmhoogfflabhh>
+
+## Verify The Install
+
+After installing both components:
+
+1. Open Chrome.
+2. Open the PrivacyGuard extension options.
+3. Confirm the native host status shows connected.
+
+The installer places the native host under `/Library/Application Support/PrivacyGuard/native-host-swift/` and registers the Chrome native messaging manifest at `/Library/Google/Chrome/NativeMessagingHosts/com.privacyguard.pii.json`.
+
+## Release Files
+
+Public Early Access releases attach only these release assets:
+
+- `PrivacyGuard-vX.Y.Z.zip`
+- `PrivacyGuard-native-host-X.Y.Z-macos-arm64-unsigned.pkg`
+- `bundle-manifest.json`
+- `SHA256SUMS.txt`
+
+The public release does not attach ICUP source archives, native-host handoff tarballs, build workspaces, signing material, or private provenance.
+
+## Trust Notice
+
+This Early Access path exists for releases made before Apple Developer ID signing and notarization are available. Apple-notarized packages provide a smoother default macOS install experience and additional Apple verification. The unsigned package requires you to decide whether to approve the exception for this release.

metadata/release-content-policy.md

@@ -13,6 +13,8 @@ Allowed tracked content:
 - `docs/**` public release-consumer documentation
 - `metadata/**` public release policy and metadata
 
+For unsigned macOS Apple Silicon Early Access releases, `docs/unsigned-native-host-install.md` is the canonical public install document. It is tracked documentation, not a GitHub Release asset.
+
 Disallowed tracked content:
 
 - ICUP source code or copied build scripts