defmodule Mix.Tasks.Crosswake.Gen.Shell do
use Mix.Task
alias Crosswake.Shell.Fixtures
@shortdoc "Generates host-owned native shell baselines for Crosswake"
@moduledoc """
Generates reviewable iOS or Android shell baselines, bundled manifest-backed
activation fixtures, and explicit ownership guidance without claiming runtime
behavior Crosswake has not proven yet.
"""
@switches [target: :string, router: :string, local: :boolean]
@platforms ~w(ios android)
@android_templates [
{"settings.gradle", "android/settings.gradle.eex"},
{"build.gradle", "android/build.gradle.eex"},
{"gradle.properties", "android/gradle.properties.eex"},
{"gradlew", "android/gradlew.eex"},
{"gradlew.bat", "android/gradlew.bat.eex"},
{"gradle/wrapper/gradle-wrapper.properties",
"android/gradle/wrapper/gradle-wrapper.properties.eex"},
{"app/build.gradle", "android/app/build.gradle.eex"},
{"app/src/main/AndroidManifest.xml", "android/app/src/main/AndroidManifest.xml.eex"},
{"app/src/main/java/dev/crosswake/shell/MainActivity.kt",
"android/app/src/main/java/dev/crosswake/shell/MainActivity.kt.eex"},
{"app/src/main/java/dev/crosswake/shell/CrosswakeViewModel.kt",
"android/app/src/main/java/dev/crosswake/shell/CrosswakeViewModel.kt.eex"},
{"app/src/main/res/values/themes.xml", "android/app/src/main/res/values/themes.xml.eex"}
]
@ios_templates [
{"CrosswakeShell/CrosswakeShellApp.swift", "ios/CrosswakeShellApp.swift.eex"},
{"CrosswakeShell/Info.plist", "ios/Info.plist.eex"},
{"CrosswakeShell/CrosswakeCoordinator.swift", "ios/CrosswakeCoordinator.swift.eex"},
{"CrosswakeShell.xcodeproj/project.pbxproj",
"ios/CrosswakeShell.xcodeproj/project.pbxproj.eex"},
{"CrosswakeShell.xcodeproj/xcshareddata/xcschemes/CrosswakeShell.xcscheme",
"ios/CrosswakeShell.xcodeproj/xcshareddata/xcschemes/CrosswakeShell.xcscheme.eex"},
{"CrosswakeShell/CrosswakeShell.entitlements", "ios/CrosswakeShell.entitlements.eex"},
{"CrosswakeShell/PrivacyInfo.xcprivacy", "ios/PrivacyInfo.xcprivacy.eex"}
]
@impl Mix.Task
def run(args) do
{opts, argv, invalid} = OptionParser.parse(args, strict: @switches)
if invalid != [] do
Mix.raise("invalid options: #{inspect(invalid)}")
end
platform =
case argv do
[platform] when platform in @platforms -> platform
_other -> Mix.raise("usage: mix crosswake.gen.shell ios|android [--target PATH]")
end
target = Path.expand(opts[:target] || File.cwd!())
capabilities = fetch_capabilities(opts[:router])
local = Keyword.get(opts, :local, false)
generated =
case platform do
"ios" -> generate_ios_shell(target, capabilities, local)
"android" -> generate_android_shell(target, capabilities, local)
end
Mix.shell().info("""
Crosswake #{platform} shell scaffold complete
generated root: #{generated.root}
ownership docs: #{generated.readme}
manifest fixture: #{generated.manifest}
activation fixture: #{generated.activation}
denial fixture: #{generated.denial}
baseline entrypoint: #{generated.entrypoint}
ownership: host-owned, scaffold once, and not safely regeneratable over host edits
""")
end
defp generate_ios_shell(target, capabilities, local) do
root = Path.join(target, "native/ios/crosswake_shell")
fixtures = Fixtures.export("ios")
readme = Path.join(root, "README.md")
entrypoint = Path.join(root, "CrosswakeShell/CrosswakeShellApp.swift")
ensure_file(readme, shell_readme("ios"))
render_ios_templates(root, capabilities, local)
write_fixture_files(root, fixtures)
%{
root: root,
readme: readme,
manifest: Path.join(root, "Fixtures/crosswake_manifest.json"),
activation: Path.join(root, "Fixtures/route_activation.json"),
denial: Path.join(root, "Fixtures/route_denial.json"),
entrypoint: entrypoint
}
end
defp generate_android_shell(target, capabilities, local) do
root = Path.join(target, "native/android/crosswake_shell")
fixtures = Fixtures.export("android")
ensure_file(Path.join(root, "README.md"), shell_readme("android"))
render_android_templates(root, capabilities, local)
entrypoint = Path.join(root, "app/src/main/java/dev/crosswake/shell/MainActivity.kt")
write_fixture_files(Path.join(root, "app/src/main"), fixtures)
ensure_executable(Path.join(root, "gradlew"))
%{
root: root,
readme: Path.join(root, "README.md"),
manifest: Path.join(root, "app/src/main/assets/crosswake_manifest.json"),
activation: Path.join(root, "app/src/main/assets/route_activation.json"),
denial: Path.join(root, "app/src/main/assets/route_denial.json"),
entrypoint: entrypoint
}
end
defp render_android_templates(root, capabilities, local) do
assigns = local_package_assigns(root)
Enum.each(@android_templates, fn {relative_path, template_path} ->
ensure_file(
Path.join(root, relative_path),
render_template(template_path, capabilities, local, assigns)
)
end)
end
defp render_ios_templates(root, capabilities, local) do
assigns = local_package_assigns(root)
Enum.each(@ios_templates, fn {relative_path, template_path} ->
ensure_file(
Path.join(root, relative_path),
render_template(template_path, capabilities, local, assigns)
)
end)
end
defp render_template(template_path, capabilities, local, assigns) do
template =
Application.app_dir(:crosswake, Path.join("priv/templates/crosswake/shell", template_path))
version = fetch_version!()
EEx.eval_file(
template,
assigns:
[
capabilities: capabilities,
local: local,
version: version
] ++ assigns
)
end
defp local_package_assigns(root) do
packages_root = Path.expand("packages", File.cwd!())
[
local_ios_core_path:
relative_path(root, Path.join(packages_root, "crosswake-shell-core-ios")),
local_android_core_path:
relative_path(root, Path.join(packages_root, "crosswake-shell-core-android"))
]
end
defp relative_path(from_dir, to_path) do
from_parts = from_dir |> Path.expand() |> Path.split()
to_parts = to_path |> Path.expand() |> Path.split()
common_length = common_prefix_length(from_parts, to_parts)
up =
from_parts
|> Enum.drop(common_length)
|> Enum.map(fn _part -> ".." end)
down = Enum.drop(to_parts, common_length)
case up ++ down do
[] -> "."
parts -> Path.join(parts)
end
end
defp common_prefix_length(left, right) do
left
|> Enum.zip(right)
|> Enum.take_while(fn {left_part, right_part} -> left_part == right_part end)
|> length()
end
defp fetch_version! do
version =
Application.spec(:crosswake, :vsn) ||
Keyword.get(Mix.Project.config(), :version)
case version do
nil ->
Mix.raise("""
could not determine the crosswake version from Application.spec(:crosswake, :vsn) or Mix.Project.config()[:version].
Run `mix app.start` before generating a shell from the Crosswake source checkout, or install crosswake as a Hex dependency in your host project.
""")
vsn ->
to_string(vsn)
end
end
defp fetch_capabilities(nil), do: Crosswake.Manifest.Builder.public_route_capability_ids()
defp fetch_capabilities(router) do
module = String.to_atom(router)
if Code.ensure_loaded?(module) do
{:ok, %{manifest: manifest}} = Crosswake.Manifest.compile(module)
Map.keys(manifest.capability_registry)
else
Mix.raise("router module #{router} is not available")
end
end
defp write_fixture_files(root, fixtures) do
Enum.each(fixtures, fn {relative_path, contents} ->
ensure_file(Path.join(root, relative_path), contents)
end)
end
defp shell_readme(platform) do
"""
# Crosswake #{String.upcase(platform)} Shell Baseline
This generated project is `host-owned`. Crosswake uses a scaffold once posture so your
team can review, ship, and patch the native shell as an application artifact.
Do not treat this directory as library-owned or safely regeneratable over host
edits.
## Included Baseline
- Real #{platform_readme_label(platform)} project files that match the class of artifact adopters ship
- Bundled canonical manifest, activation, denial, and pack inventory fixtures
- Thin native seams for app boot, manifest loading, and route-unavailable handling
## Boundary
- The generated shell is intentionally thin and manifest-first.
- Crosswake does not claim offline journals, pack managers, or broad plugin registries here.
- Upgrade this shell with patch-or-doc guidance after generation instead of expecting safe re-ownership.
"""
end
defp platform_readme_label("ios"), do: "Xcode"
defp platform_readme_label("android"), do: "Android Studio"
defp ensure_file(path, contents) do
File.mkdir_p!(Path.dirname(path))
case File.read(path) do
{:ok, _existing} ->
:reused
{:error, :enoent} ->
File.write!(path, contents)
:created
{:error, reason} ->
Mix.raise("could not create #{path}: #{:file.format_error(reason)}")
end
end
defp ensure_executable(path) do
case File.stat(path) do
{:ok, %File.Stat{mode: mode}} ->
File.chmod!(path, Bitwise.bor(mode, 0o111))
{:error, reason} ->
Mix.raise("could not update permissions for #{path}: #{:file.format_error(reason)}")
end
end
end