feat(iSH): add hooks for iOS rootfs integration and library linking

Signed-off-by: 7HR4IZ3 <90985774+7HR4IZ3@users.noreply.github.com>

Author: 7HR4IZ3

docs/ISH_INTEGRATION.md

@@ -9,6 +9,7 @@ Goal: provide an iSH-style x86 Alpine environment on iOS and bridge it to the ex
 - Output streaming is hooked by swizzling `Terminal sendOutput:length:` and forwarding to Cordova callbacks.
 - Rootfs bootstrap copies `ish-rootfs` from app bundle to `Documents/ish-rootfs` if present.
 - Rootfs path is provided via `DefaultRootPath()` (weak symbol in `IshRootfs.c`).
+- Hooks copy `src/ios/ish-rootfs` into the iOS app bundle after prepare.
 
 ## Key iSH entry points
 
@@ -50,9 +51,13 @@ Goal: provide an iSH-style x86 Alpine environment on iOS and bridge it to the ex
 Scripts:
 - `scripts/build-ish.sh` for building iSH (macOS + Xcode).
 - `scripts/sync-ish-headers.sh` for syncing required headers.
+- `scripts/prepare-ish-rootfs.sh` to extract an Alpine rootfs into `src/ios/ish-rootfs`.
+Scripts:
+- `scripts/build-ish.sh` for building iSH (macOS + Xcode).
+- `scripts/sync-ish-headers.sh` for syncing required headers.
 
 ## Next TODOs
 
 - Bundle Alpine rootfs under `ish-rootfs` and validate `/bin/sh`.
-- Link iSH static lib into Cordova build.
+- Link iSH static lib into Cordova build (hooks added, requires `xcode` npm package).
 - Add exit event callbacks when sessions terminate.

hooks/ios/add-ish-lib.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+function findXcodeProj(platformsPath) {
+  if (!fs.existsSync(platformsPath)) return null;
+  const entries = fs.readdirSync(platformsPath).filter((name) => name.endsWith(".xcodeproj"));
+  if (!entries.length) return null;
+  return path.join(platformsPath, entries[0], "project.pbxproj");
+}
+
+function main() {
+  const projectRoot = process.cwd();
+  const iosPath = path.join(projectRoot, "platforms", "ios");
+  const pbxprojPath = findXcodeProj(iosPath);
+  if (!pbxprojPath) {
+    console.log("iSH hook: no iOS Xcode project found, skipping.");
+    return;
+  }
+
+  let xcode;
+  try {
+    xcode = require("xcode");
+  } catch (err) {
+    console.log("iSH hook: npm package 'xcode' not installed. Skipping auto-link.\n" +
+      "Install dev dependency or link libiSH manually in Xcode.");
+    return;
+  }
+
+  const libPath = path.join(projectRoot, "third_party", "ish", "build", "Release-iphoneos", "libiSHLinux.a");
+  if (!fs.existsSync(libPath)) {
+    console.log("iSH hook: libiSHLinux.a not found at", libPath);
+    console.log("Build iSH first (scripts/build-ish.sh) or adjust hook path.");
+    return;
+  }
+
+  const project = xcode.project(pbxprojPath);
+  project.parseSync();
+
+  const target = project.getFirstTarget().uuid;
+  project.addFile(libPath, "Frameworks", target);
+  project.addFramework(libPath, { customFramework: true, embed: false });
+
+  fs.writeFileSync(pbxprojPath, project.writeSync());
+  console.log("iSH hook: linked libiSHLinux.a");
+}
+
+main();

hooks/ios/add-ish-rootfs.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+function copyDir(src, dest) {
+  if (!fs.existsSync(src)) return;
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src)) {
+    const srcPath = path.join(src, entry);
+    const destPath = path.join(dest, entry);
+    const stat = fs.statSync(srcPath);
+    if (stat.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function main() {
+  const projectRoot = process.cwd();
+  const iosPath = path.join(projectRoot, "platforms", "ios");
+  if (!fs.existsSync(iosPath)) {
+    console.log("iSH rootfs hook: no iOS platform found, skipping.");
+    return;
+  }
+
+  const appDir = fs.readdirSync(iosPath).find((name) => name.endsWith(".xcodeproj"));
+  if (!appDir) {
+    console.log("iSH rootfs hook: no Xcode project found, skipping.");
+    return;
+  }
+
+  const appName = appDir.replace(/\.xcodeproj$/, "");
+  const srcRootfs = path.join(projectRoot, "src", "ios", "ish-rootfs");
+  const destRootfs = path.join(iosPath, appName, "ish-rootfs");
+
+  if (!fs.existsSync(srcRootfs)) {
+    console.log("iSH rootfs hook: src/ios/ish-rootfs not found, skipping.");
+    return;
+  }
+
+  copyDir(srcRootfs, destRootfs);
+  console.log("iSH rootfs hook: copied rootfs to", destRootfs);
+}
+
+main();

scripts/prepare-ish-rootfs.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DEST="$ROOT_DIR/src/ios/ish-rootfs"
+ARCHIVE="${1:-}"
+
+if [[ -z "$ARCHIVE" ]]; then
+  echo "Usage: $0 /path/to/alpine-rootfs.tar.gz"
+  exit 1
+fi
+
+if [[ ! -f "$ARCHIVE" ]]; then
+  echo "Archive not found: $ARCHIVE"
+  exit 1
+fi
+
+rm -rf "$DEST"
+mkdir -p "$DEST"
+
+tar -xzf "$ARCHIVE" -C "$DEST"
+
+echo "Rootfs extracted to $DEST"

src/ios/ish-rootfs/.gitkeep

@@ -92,5 +92,7 @@
         <source-file src="src/ios/IshRootfs.c" />
         <header-file src="src/ios/ish/include/LinuxInterop.h" />
         <header-file src="src/ios/ish/include/Terminal.h" />
+        <hook type="after_prepare" src="hooks/ios/add-ish-lib.js" />
+        <hook type="after_prepare" src="hooks/ios/add-ish-rootfs.js" />
     </platform>
 </plugin>