biucingcli 0.9.1__py3-none-any.whl

biucingcli/template_data/apple/template/scripts/doctor

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+failures=0
+warnings=0
+platform="{{APPLE_PLATFORM}}"
+platform_name="{{APPLE_PLATFORM_NAME}}"
+repo_root="$(pwd)"
+worktree_id="${WORKTREE_ID:-$(printf '%s' "$repo_root" | shasum | cut -c1-8)}"
+tuist_home="${TUIST_HOME:-${repo_root}/.cache/tuist/${worktree_id}/home}"
+tuist_xdg_cache="${TUIST_XDG_CACHE_HOME:-${repo_root}/.cache/tuist/${worktree_id}/xdg-cache}"
+tuist_xdg_state="${TUIST_XDG_STATE_HOME:-${repo_root}/.cache/tuist/${worktree_id}/xdg-state}"
+tuist_xdg_config="${TUIST_XDG_CONFIG_HOME:-${repo_root}/.cache/tuist/${worktree_id}/xdg-config}"
+tuist_tmp="${TUIST_TMPDIR:-${repo_root}/.cache/tuist/${worktree_id}/tmp}"
+
+pass() {
+  echo "[pass] $1"
+}
+
+warn() {
+  echo "[warn] $1"
+  warnings=$((warnings + 1))
+}
+
+fail() {
+  echo "[fail] $1"
+  failures=$((failures + 1))
+}
+
+echo "Apple environment doctor"
+echo "platform: ${platform_name}"
+
+developer_dir=""
+if developer_dir="$(xcode-select -p 2>/dev/null)"; then
+  pass "xcode-select points to ${developer_dir}"
+else
+  fail "xcode-select is not configured. Open Xcode once or run 'sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer'."
+fi
+
+if command -v xcodebuild >/dev/null 2>&1; then
+  xcodebuild_version="$(xcodebuild -version 2>&1 || true)"
+  if [[ "$xcodebuild_version" == Xcode* ]]; then
+    pass "xcodebuild is available"
+    echo "$xcodebuild_version" | sed -n '1,2p'
+  else
+    fail "xcodebuild is installed but not usable. Output: ${xcodebuild_version}"
+  fi
+else
+  fail "xcodebuild is not available. Install Xcode and accept the license before building."
+fi
+
+if command -v tuist >/dev/null 2>&1; then
+  mkdir -p "$tuist_home" "$tuist_xdg_cache" "$tuist_xdg_state" "$tuist_xdg_config" "$tuist_tmp"
+  tuist_version_output="$(
+    HOME="$tuist_home" \
+    XDG_CACHE_HOME="$tuist_xdg_cache" \
+    XDG_STATE_HOME="$tuist_xdg_state" \
+    XDG_CONFIG_HOME="$tuist_xdg_config" \
+    TMPDIR="$tuist_tmp" \
+    tuist version 2>&1 || true
+  )"
+  if [[ "$tuist_version_output" =~ ^[0-9] ]]; then
+    pass "tuist is available"
+    echo "tuist: ${tuist_version_output}"
+  else
+    fail "tuist is installed but not usable. Output: ${tuist_version_output}"
+  fi
+else
+  fail "tuist is not available. Run 'brew bundle' or install Tuist before generating the workspace."
+fi
+
+if command -v swift >/dev/null 2>&1; then
+  swift_version_output="$(swift --version 2>&1 || true)"
+  if [[ "$swift_version_output" == *"swift-driver version"* || "$swift_version_output" == *"Apple Swift version"* ]]; then
+    pass "swift is available"
+    echo "$swift_version_output" | head -n 1
+  else
+    fail "swift is installed but not usable. Output: ${swift_version_output}"
+  fi
+else
+  fail "swift is not available. Install Xcode command line tools before continuing."
+fi
+
+if command -v swiftlint >/dev/null 2>&1; then
+  swiftlint_version_output="$(swiftlint version 2>&1 || true)"
+  if [[ -n "$swiftlint_version_output" ]]; then
+    pass "swiftlint is available"
+    echo "swiftlint: ${swiftlint_version_output}"
+  else
+    fail "swiftlint is installed but did not return a version."
+  fi
+else
+  fail "swiftlint is not available. Run 'brew bundle' before using make lint."
+fi
+
+if command -v swiftformat >/dev/null 2>&1; then
+  swiftformat_version_output="$(swiftformat --version 2>&1 || true)"
+  if [[ -n "$swiftformat_version_output" ]]; then
+    pass "swiftformat is available"
+    echo "swiftformat: ${swiftformat_version_output}"
+  else
+    fail "swiftformat is installed but did not return a version."
+  fi
+else
+  fail "swiftformat is not available. Run 'brew bundle' before using make format."
+fi
+
+if command -v fastlane >/dev/null 2>&1; then
+  fastlane_version_output="$(fastlane --version 2>&1 || true)"
+  if [[ -n "$fastlane_version_output" ]]; then
+    pass "fastlane is available"
+    echo "$fastlane_version_output" | sed -n '1p'
+  else
+    warn "fastlane is installed but did not return version information. Beta and release automation may fail."
+  fi
+else
+  warn "fastlane is not available. Run 'brew bundle' before using make beta or make release."
+fi
+
+if command -v xcrun >/dev/null 2>&1; then
+  simctl_output="$(xcrun simctl list devices available 2>&1 || true)"
+  if [[ "$simctl_output" == *"Unable to locate device set"* || "$simctl_output" == *"CoreSimulatorService connection became invalid"* || "$simctl_output" == *"Failed to initialize simulator device set"* ]]; then
+    if [[ "$platform" == "macos" ]]; then
+      warn "xcrun simctl is installed but simulator services are not ready. macOS builds can still proceed, but iOS-family simulator workflows may fail. Output: ${simctl_output}"
+    else
+      fail "xcrun simctl could not inspect available simulators. Resolve CoreSimulator service issues before running ${platform_name} tests. Output: ${simctl_output}"
+    fi
+  elif [[ "$simctl_output" == *"=="* || -n "$(printf '%s' "$simctl_output" | sed '/^$/d')" ]]; then
+    available_devices="$(printf '%s\n' "$simctl_output" | rg -c '^    ' || true)"
+    if [[ "${available_devices:-0}" -gt 0 ]]; then
+      pass "xcrun simctl can see ${available_devices} available simulator device(s)"
+    else
+      if [[ "$platform" == "macos" ]]; then
+        warn "xcrun simctl is available, but no simulator devices were listed. macOS builds can still proceed."
+      else
+        fail "xcrun simctl is available, but no simulator devices were listed. Install a ${platform_name} runtime and create a simulator before running tests."
+      fi
+    fi
+  else
+    if [[ "$platform" == "macos" ]]; then
+      warn "xcrun simctl returned an unexpected result. macOS builds can still proceed, but simulator inspection is unreliable. Output: ${simctl_output}"
+    else
+      fail "xcrun simctl returned an unexpected result while checking simulators. Output: ${simctl_output}"
+    fi
+  fi
+else
+  if [[ "$platform" == "macos" ]]; then
+    warn "xcrun is not available, so simulator readiness could not be checked."
+  else
+    fail "xcrun is not available, so simulator readiness could not be checked for ${platform_name}."
+  fi
+fi
+
+if (( failures > 0 )); then
+  echo "Doctor found ${failures} issue(s) and ${warnings} warning(s)."
+  exit 1
+fi
+
+if (( warnings > 0 )); then
+  echo "Doctor completed with ${warnings} warning(s)."
+else
+  echo "Environment looks ready."
+fi

biucingcli/template_data/apple/template/scripts/setup-xcode

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+DEVELOPER_DIR_PATH="$(xcode-select -p)"
+echo "Using developer directory: ${DEVELOPER_DIR_PATH}"
+xcodebuild -version

biucingcli/template_data/apple/template/scripts/test-destination

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+platform="${1:-ios}"
+
+case "$platform" in
+  ios)
+    runtime_label="iOS"
+    ;;
+  watchos)
+    runtime_label="watchOS"
+    ;;
+  tvos)
+    runtime_label="tvOS"
+    ;;
+  macos)
+    printf '%s\n' "platform=macOS"
+    exit 0
+    ;;
+  *)
+    printf 'Unsupported Apple platform for tests: %s\n' "$platform" >&2
+    exit 1
+    ;;
+esac
+
+device_line="$(
+  xcrun simctl list devices available 2>/dev/null \
+    | awk -v label="$runtime_label" '
+        $0 ~ "^-- " label " " { active = 1; next }
+        $0 ~ "^-- " { active = 0 }
+        active && /^    / { print; exit }
+      '
+)"
+
+udid="$(printf '%s\n' "$device_line" | sed -E 's/.*\(([0-9A-Fa-f-]{36})\).*/\1/')"
+
+if [[ -z "$udid" || "$udid" == "$device_line" ]]; then
+  printf 'No available %s simulator was found. Install a runtime and create a simulator, then rerun make test.\n' "$runtime_label" >&2
+  exit 1
+fi
+
+printf 'id=%s\n' "$udid"

biucingcli/template_data/apple/template/scripts/verify-release-identity

@@ -0,0 +1,88 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "json"
+require "open3"
+
+EXPECTED_BUNDLE_IDENTIFIER = "{{BUNDLE_IDENTIFIER}}"
+WORKSPACE = "{{PROJECT_NAME}}.xcworkspace"
+SCHEME = "{{SWIFT_MODULE_NAME}}"
+
+def fail_identity(message, actual: nil)
+  warn "Apple release identity check failed: #{message}"
+  warn "Expected: #{EXPECTED_BUNDLE_IDENTIFIER}"
+  warn "Actual: #{actual || '<missing>'}"
+  exit 1
+end
+
+def run_command(*command)
+  stdout, stderr, status = Open3.capture3(*command)
+  return stdout if status.success?
+
+  warn stderr unless stderr.empty?
+  fail_identity("command failed: #{command.join(' ')}")
+rescue Errno::ENOENT => error
+  fail_identity("command is unavailable: #{error.message}")
+end
+
+def verify_workspace
+  output = run_command(
+    "xcodebuild",
+    "-workspace", WORKSPACE,
+    "-scheme", SCHEME,
+    "-configuration", "Release",
+    "-showBuildSettings",
+    "-json"
+  )
+
+  settings = JSON.parse(output)
+  fail_identity("xcodebuild JSON root must be an array") unless settings.is_a?(Array)
+
+  app_targets = settings.select { |entry| entry["target"] == SCHEME }
+  unless app_targets.length == 1
+    fail_identity("expected exactly one Release build-settings entry for target #{SCHEME}")
+  end
+
+  actual = app_targets.first.fetch("buildSettings", {})["PRODUCT_BUNDLE_IDENTIFIER"]
+  unless actual == EXPECTED_BUNDLE_IDENTIFIER
+    fail_identity("Release build settings use the wrong bundle identifier", actual: actual)
+  end
+
+  puts "Apple Release workspace identity verified: #{actual}"
+rescue JSON::ParserError => error
+  fail_identity("xcodebuild returned invalid JSON: #{error.message}")
+end
+
+def verify_archive(path)
+  info_plist = File.join(path, "Info.plist")
+  fail_identity("archive Info.plist is missing: #{info_plist}") unless File.file?(info_plist)
+
+  actual = run_command(
+    "/usr/libexec/PlistBuddy",
+    "-c", "Print :ApplicationProperties:CFBundleIdentifier",
+    info_plist
+  ).strip
+  unless actual == EXPECTED_BUNDLE_IDENTIFIER
+    fail_identity("archive uses the wrong bundle identifier", actual: actual)
+  end
+
+  puts "Apple Release archive identity verified: #{actual}"
+end
+
+mode = ARGV.shift
+
+case mode
+when "workspace"
+  fail_identity("workspace mode does not accept extra arguments") unless ARGV.empty?
+  verify_workspace
+when "archive"
+  archive_path = ARGV.shift
+  if archive_path.to_s.empty? || !ARGV.empty?
+    fail_identity("archive mode requires exactly one xcarchive path")
+  end
+  verify_archive(archive_path)
+else
+  warn "Usage: ./scripts/verify-release-identity workspace"
+  warn "       ./scripts/verify-release-identity archive PATH_TO_XCARCHIVE"
+  exit 2
+end

biucingcli/template_data/apple/template.json

@@ -0,0 +1,110 @@
+{
+  "name": "apple",
+  "description": "Swift + Tuist Apple app starter for mid-sized teams",
+  "category": "native",
+  "stack": ["Swift", "Tuist", "SwiftPM", "fastlane"],
+  "tags": ["apple", "swiftui", "tuist", "fastlane"],
+  "platforms": ["ios", "macos", "watchos", "tvos"],
+  "maturity": {
+    "level": "validated",
+    "summary": "Multi-platform Apple starter with doctor, generate, lint, test, beta, and release workflows."
+  },
+  "validation": {
+    "status": "generated-project-verified",
+    "verification_tier": "generated-project",
+    "evidence": [
+      "python unittest template rendering coverage",
+      "real generated project make generate/build/test validation"
+    ]
+  },
+  "operating_assumptions": [
+    "The starter assumes a native Apple workstation with Xcode-oriented tooling and simulator-first validation.",
+    "Generated projects should keep bootstrap, doctor, generate, lint, test, beta, and release workflows explicit."
+  ],
+  "workflow_labels": ["bootstrap", "doctor", "generate", "lint", "test", "build", "release", "open"],
+  "commands": {
+    "bootstrap": "make bootstrap",
+    "doctor": "make doctor",
+    "lint": "make lint",
+    "test": "make test",
+    "verify": "make verify",
+    "build": "make build",
+    "clean": "make clean",
+    "help": "make help"
+  },
+  "worktree": {
+    "support_level": "worktree-ready",
+    "isolation_dimensions": [
+      "caches",
+      "generated-output",
+      "local-config",
+      "installed-app-identity",
+      "cleanup",
+      "diagnostics"
+    ],
+    "diagnostics": [
+      "make worktree-info",
+      "make worktree-doctor"
+    ],
+    "cleanup": [
+      "make clean-worktree"
+    ]
+  },
+  "variables": [
+    {
+      "name": "project_name",
+      "required": true,
+      "validator": "project-name"
+    },
+    {
+      "name": "display_name",
+      "required": false,
+      "default_from": "project_name",
+      "validator": "display-name"
+    },
+    {
+      "name": "apple_platform",
+      "required": false,
+      "default": "ios",
+      "validator": "choice",
+      "choices": ["ios", "macos", "watchos", "tvos"]
+    },
+    {
+      "name": "bundle_identifier",
+      "required": true,
+      "prompt": "Bundle identifier: ",
+      "validator": "bundle-identifier"
+    },
+    {
+      "name": "organization_name",
+      "required": false,
+      "default": "Example Team",
+      "validator": "display-name"
+    },
+    {
+      "name": "development_team",
+      "required": false,
+      "default": "DEVELOPMENT_TEAM_ID",
+      "validator": "team-id"
+    },
+    {
+      "name": "minimum_os_version",
+      "required": false,
+      "default": "26.0",
+      "validator": "apple-version"
+    },
+    {
+      "name": "swift_module_name",
+      "required": false,
+      "validator": "identifier"
+    }
+  ],
+  "next_steps": [
+    "make bootstrap",
+    "make doctor",
+    "make generate",
+    "make lint",
+    "make test",
+    "open {{PROJECT_NAME}}.xcworkspace"
+  ]
+}

biucingcli/template_data/frontend/template/.dockerignore

@@ -0,0 +1,8 @@
+node_modules/
+.pnpm-home/
+.pnpm-store/
+dist/
+playwright-report/
+test-results/
+.git/
+.DS_Store

biucingcli/template_data/frontend/template/.env.example

@@ -0,0 +1 @@
+VITE_API_BASE_URL=http://localhost:8080

biucingcli/template_data/frontend/template/.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+.pnpm-home/
+.pnpm-store/
+dist/
+playwright-report/
+test-results/
+.DS_Store

biucingcli/template_data/frontend/template/.npmrc

@@ -0,0 +1 @@
+store-dir=.pnpm-store

biucingcli/template_data/frontend/template/.prettierignore

@@ -0,0 +1,2 @@
+dist
+node_modules

biucingcli/template_data/frontend/template/.prettierrc.json

@@ -0,0 +1,4 @@
+{
+  "singleQuote": false,
+  "trailingComma": "all"
+}

biucingcli/template_data/frontend/template/Dockerfile

@@ -0,0 +1,25 @@
+ARG BUILDER_IMAGE=node:20-alpine
+ARG RUNTIME_IMAGE=nginx:1.27-alpine
+
+FROM ${BUILDER_IMAGE} AS builder
+
+WORKDIR /app
+
+COPY package.json pnpm-lock.yaml ./
+RUN corepack enable && corepack prepare pnpm@9.9.0 --activate \
+    && pnpm install --frozen-lockfile
+
+COPY . .
+RUN pnpm build
+
+FROM ${RUNTIME_IMAGE}
+
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=builder /app/dist /usr/share/nginx/html
+
+EXPOSE 80
+
+HEALTHCHECK --interval=1s --timeout=2s --start-period=2s --retries=30 \
+  CMD wget -q -O /dev/null http://127.0.0.1/ || exit 1
+
+CMD ["nginx", "-g", "daemon off;"]

biucingcli/template_data/frontend/template/Dockerfile.dev

@@ -0,0 +1,35 @@
+ARG DEV_BASE_IMAGE=node:20-bookworm
+FROM ${DEV_BASE_IMAGE}
+
+WORKDIR /workspace
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        bash \
+        ca-certificates \
+        git \
+        libasound2 \
+        libatk-bridge2.0-0 \
+        libatk1.0-0 \
+        libatspi2.0-0 \
+        libcups2 \
+        libdbus-1-3 \
+        libgbm1 \
+        libgtk-3-0 \
+        libnspr4 \
+        libnss3 \
+        libxcomposite1 \
+        libxdamage1 \
+        libxfixes3 \
+        libxkbcommon0 \
+        libxrandr2 \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN corepack enable && corepack prepare pnpm@9.9.0 --activate
+
+ENV CI=1
+ENV PNPM_STORE_DIR=/pnpm-store
+ENV npm_config_store_dir=/pnpm-store
+ENV PLAYWRIGHT_BROWSERS_PATH=/ms-playwright
+
+CMD ["bash", "-lc", "if [ ! -d node_modules/.pnpm ]; then pnpm install --frozen-lockfile; fi; pnpm dev --host 0.0.0.0 --port 5173"]

biucingcli/template_data/frontend/template/Dockerfile.dev.full

@@ -0,0 +1,40 @@
+ARG DEV_BASE_IMAGE=node:20-bookworm
+FROM ${DEV_BASE_IMAGE}
+
+WORKDIR /workspace
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        bash \
+        ca-certificates \
+        git \
+        libasound2 \
+        libatk-bridge2.0-0 \
+        libatk1.0-0 \
+        libatspi2.0-0 \
+        libcups2 \
+        libdbus-1-3 \
+        libgbm1 \
+        libgtk-3-0 \
+        libnspr4 \
+        libnss3 \
+        libxcomposite1 \
+        libxdamage1 \
+        libxfixes3 \
+        libxkbcommon0 \
+        libxrandr2 \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN corepack enable && corepack prepare pnpm@9.9.0 --activate
+
+ENV CI=1
+ENV PNPM_STORE_DIR=/pnpm-store
+ENV npm_config_store_dir=/pnpm-store
+ENV PLAYWRIGHT_BROWSERS_PATH=/ms-playwright
+
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --frozen-lockfile \
+    && pnpm exec playwright install chromium \
+    && rm -rf node_modules
+
+CMD ["bash", "-lc", "if [ ! -d node_modules/.pnpm ]; then pnpm install --frozen-lockfile; fi; pnpm dev --host 0.0.0.0 --port 5173"]