Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

scripts/lib/ios-version.ts

@@ -0,0 +1,171 @@
+// Ios Version script supports OpenClaw repository automation.
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { parseReleaseVersion } from "./npm-publish-plan.mjs";
+
+const IOS_CHANGELOG_FILE = "apps/ios/CHANGELOG.md";
+
+type ResolvedIosVersion = {
+  canonicalVersion: string;
+  marketingVersion: string;
+  buildVersion: string;
+  changelogPath: string;
+  versionSource: "explicit" | "package";
+  versionSourcePath: string | null;
+};
+
+type SyncIosVersioningMode = "check" | "write";
+
+function parsePinnedReleaseVersion(rawVersion: string): string | null {
+  const parsed = parseReleaseVersion(rawVersion.trim());
+  if (!parsed || parsed.version !== parsed.baseVersion) {
+    return null;
+  }
+  return parsed.baseVersion;
+}
+
+export function normalizePinnedIosVersion(rawVersion: string): string {
+  const trimmed = rawVersion.trim();
+  if (!trimmed) {
+    throw new Error("Missing iOS release version.");
+  }
+
+  const pinnedVersion = parsePinnedReleaseVersion(trimmed);
+  if (!pinnedVersion) {
+    throw new Error(`Invalid iOS version '${rawVersion}'. Expected release version like 2026.6.5.`);
+  }
+
+  return pinnedVersion;
+}
+
+export function normalizeGatewayVersionToPinnedIosVersion(rawVersion: string): string {
+  const trimmed = rawVersion.trim().replace(/^v/u, "");
+  if (!trimmed) {
+    throw new Error("Missing root package.json version.");
+  }
+
+  const parsed = parseReleaseVersion(trimmed);
+  if (!parsed) {
+    throw new Error(
+      `Invalid gateway version '${rawVersion}'. Expected YYYY.M.PATCH, YYYY.M.PATCH-alpha.N, YYYY.M.PATCH-beta.N, or YYYY.M.PATCH-N.`,
+    );
+  }
+
+  return parsed.baseVersion;
+}
+
+function rootPackageJsonPath(rootDir = path.resolve(".")): string {
+  return path.join(rootDir, "package.json");
+}
+
+function readRootPackageVersion(rootDir = path.resolve(".")): string {
+  const packageJsonPath = rootPackageJsonPath(rootDir);
+  const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8")) as { version?: unknown };
+  const version = typeof parsed.version === "string" ? parsed.version.trim() : "";
+  if (!version) {
+    throw new Error(`Missing package.json version in ${packageJsonPath}.`);
+  }
+  return version;
+}
+
+export function resolveGatewayVersionForIosRelease(rootDir = path.resolve(".")): {
+  packageVersion: string;
+  pinnedIosVersion: string;
+} {
+  const packageVersion = readRootPackageVersion(rootDir);
+  return {
+    packageVersion,
+    pinnedIosVersion: normalizeGatewayVersionToPinnedIosVersion(packageVersion),
+  };
+}
+
+export function resolveIosVersion(
+  rootDir = path.resolve("."),
+  options?: { releaseVersion?: string | null },
+): ResolvedIosVersion {
+  const changelogPath = path.join(rootDir, IOS_CHANGELOG_FILE);
+  const explicitReleaseVersion = options?.releaseVersion?.trim() ?? "";
+  const canonicalVersion = explicitReleaseVersion
+    ? normalizePinnedIosVersion(explicitReleaseVersion)
+    : resolveGatewayVersionForIosRelease(rootDir).pinnedIosVersion;
+
+  return {
+    canonicalVersion,
+    marketingVersion: canonicalVersion,
+    buildVersion: "1",
+    changelogPath,
+    versionSource: explicitReleaseVersion ? "explicit" : "package",
+    versionSourcePath: explicitReleaseVersion ? null : rootPackageJsonPath(rootDir),
+  };
+}
+
+function matchChangelogHeading(line: string, heading: string): boolean {
+  const normalized = line.trim();
+  return normalized === `## ${heading}` || normalized.startsWith(`## ${heading} - `);
+}
+
+export function extractChangelogSection(content: string, heading: string): string | null {
+  const lines = content.split(/\r?\n/);
+  const startIndex = lines.findIndex((line) => matchChangelogHeading(line, heading));
+  if (startIndex === -1) {
+    return null;
+  }
+
+  let endIndex = lines.length;
+  for (let index = startIndex + 1; index < lines.length; index += 1) {
+    if (lines[index]?.startsWith("## ")) {
+      endIndex = index;
+      break;
+    }
+  }
+
+  const body = lines
+    .slice(startIndex + 1, endIndex)
+    .join("\n")
+    .trim();
+  return body || null;
+}
+
+export function renderIosReleaseNotes(
+  version: ResolvedIosVersion,
+  changelogContent: string,
+): string {
+  const candidateHeadings = [version.canonicalVersion, "Unreleased"];
+
+  for (const heading of candidateHeadings) {
+    const body = extractChangelogSection(changelogContent, heading);
+    if (body) {
+      return `${body}\n`;
+    }
+  }
+
+  throw new Error(
+    `Unable to find iOS changelog notes for ${version.canonicalVersion}. Add a matching section to ${IOS_CHANGELOG_FILE}.`,
+  );
+}
+
+export function syncIosVersioning(params?: {
+  mode?: SyncIosVersioningMode;
+  releaseVersion?: string | null;
+  rootDir?: string;
+}): {
+  updatedPaths: string[];
+} {
+  const rootDir = path.resolve(params?.rootDir ?? ".");
+  const releaseVersion = params?.releaseVersion;
+  const version = resolveIosVersion(rootDir, { releaseVersion });
+  const changelogContent = readFileSync(version.changelogPath, "utf8");
+  renderIosReleaseNotes(version, changelogContent);
+
+  return { updatedPaths: [] };
+}
+
+export function renderIosReleaseNotesForVersion(params?: {
+  releaseVersion?: string | null;
+  rootDir?: string;
+}): string {
+  const rootDir = path.resolve(params?.rootDir ?? ".");
+  const version = resolveIosVersion(rootDir, { releaseVersion: params?.releaseVersion });
+  const changelogContent = readFileSync(version.changelogPath, "utf8");
+  return renderIosReleaseNotes(version, changelogContent);
+}