biucingcli 0.9.1__py3-none-any.whl

biucingcli/template_data/android/template/scripts/verify-release-artifact

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+artifact_path="${1:-app/build/outputs/bundle/release/app-release.aab}"
+properties_path="local.properties"
+keytool_bin="${KEYTOOL:-keytool}"
+jarsigner_bin="${JARSIGNER:-jarsigner}"
+
+property_value() {
+  local property_name="$1"
+  local environment_name="$2"
+  local environment_value="${!environment_name:-}"
+  if [[ -n "$environment_value" ]]; then
+    printf '%s' "$environment_value"
+  elif [[ -f "$properties_path" ]]; then
+    awk -F= -v key="$property_name" '
+      $0 !~ /^[[:space:]]*#/ && $1 ~ "^[[:space:]]*" key "[[:space:]]*$" {
+        sub(/^[^=]*=/, ""); sub(/^[[:space:]]+/, ""); sub(/[[:space:]]+$/, ""); print; exit
+      }
+    ' "$properties_path"
+  fi
+}
+
+normalize_fingerprint() {
+  tr '[:lower:]' '[:upper:]' | tr -d ':[:space:]'
+}
+
+certificate_fingerprint() {
+  sed -nE 's/.*SHA-?256:[[:space:]]*([0-9A-Fa-f:]+).*/\1/p' | head -n 1 | normalize_fingerprint
+}
+
+echo "Android release artifact signature verification"
+
+if [[ ! -s "$artifact_path" ]]; then
+  echo "AAB is missing or empty: $artifact_path" >&2
+  exit 1
+fi
+if ! unzip -tqq "$artifact_path"; then
+  echo "AAB archive validation failed: $artifact_path" >&2
+  exit 1
+fi
+for entry in BundleConfig.pb base/manifest/AndroidManifest.xml; do
+  if ! unzip -p "$artifact_path" "$entry" >/dev/null; then
+    echo "AAB does not contain required entry: $entry" >&2
+    exit 1
+  fi
+done
+
+for tool in "$keytool_bin" "$jarsigner_bin"; do
+  if ! command -v "$tool" >/dev/null 2>&1 && [[ ! -x "$tool" ]]; then
+    echo "Required JDK signing tool is unavailable: $tool" >&2
+    exit 1
+  fi
+done
+
+store_file="$(property_value biucing.release.storeFile BIUCING_RELEASE_STORE_FILE)"
+store_password="$(property_value biucing.release.storePassword BIUCING_RELEASE_STORE_PASSWORD)"
+key_alias="$(property_value biucing.release.keyAlias BIUCING_RELEASE_KEY_ALIAS)"
+if [[ -z "$store_file" || -z "$store_password" || -z "$key_alias" ]]; then
+  echo "Release keystore path, store password, and key alias are required for artifact verification." >&2
+  exit 1
+fi
+if [[ "$store_file" != /* ]]; then
+  store_file="$PWD/$store_file"
+fi
+if [[ ! -f "$store_file" ]]; then
+  echo "Release keystore does not exist: $store_file" >&2
+  exit 1
+fi
+
+verification_output="$(mktemp "${TMPDIR:-/tmp}/biucing-jarsigner.XXXXXX")"
+cleanup() {
+  rm -f "$verification_output"
+  unset BIUCING_KEYSTORE_PASSWORD_INPUT
+}
+trap cleanup EXIT HUP INT TERM
+
+LC_ALL=C "$jarsigner_bin" -verify -verbose -certs "$artifact_path" >"$verification_output" 2>&1 || {
+  echo "AAB cryptographic signature verification failed." >&2
+  sed -n '1,20p' "$verification_output" >&2
+  exit 1
+}
+if ! grep -q 'jar verified' "$verification_output" || grep -q 'unsigned entry' "$verification_output"; then
+  echo "AAB is not fully JAR-signed." >&2
+  exit 1
+fi
+
+export BIUCING_KEYSTORE_PASSWORD_INPUT="$store_password"
+expected_fingerprint="$(LC_ALL=C "$keytool_bin" -list -v -keystore "$store_file" -alias "$key_alias" -storepass:env BIUCING_KEYSTORE_PASSWORD_INPUT 2>/dev/null | certificate_fingerprint)"
+actual_fingerprint="$(LC_ALL=C "$keytool_bin" -printcert -jarfile "$artifact_path" 2>/dev/null | certificate_fingerprint)"
+unset BIUCING_KEYSTORE_PASSWORD_INPUT
+
+if [[ -z "$expected_fingerprint" || -z "$actual_fingerprint" ]]; then
+  echo "Unable to read the expected or actual signer SHA-256 fingerprint." >&2
+  exit 1
+fi
+if [[ "$actual_fingerprint" != "$expected_fingerprint" ]]; then
+  echo "AAB signer certificate does not match the configured release key." >&2
+  echo "expected: $expected_fingerprint" >&2
+  echo "actual:   $actual_fingerprint" >&2
+  exit 1
+fi
+
+echo "AAB signature is valid and matches the configured release certificate."

biucingcli/template_data/android/template/settings.gradle.kts

@@ -0,0 +1,25 @@
+pluginManagement {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+rootProject.name = "{{PROJECT_NAME}}"
+
+include(":app")
+include(":core:model")
+include(":core:designsystem")
+include(":core:network")
+include(":core:testing")
+include(":feature:home")
+include(":feature:settings")

biucingcli/template_data/android/template.json

@@ -0,0 +1,146 @@
+{
+  "name": "android",
+  "description": "Kotlin Android app starter for mid-sized teams",
+  "category": "native",
+  "stack": ["Kotlin", "Android", "Gradle", "Jetpack Compose", "fastlane"],
+  "tags": ["android", "kotlin", "compose", "fastlane"],
+  "platforms": ["android"],
+  "maturity": {
+    "level": "validated",
+    "summary": "Android starter with doctor, format, build, test, and UI smoke workflows."
+  },
+  "validation": {
+    "status": "generated-project-verified",
+    "verification_tier": "generated-project",
+    "evidence": [
+      "python unittest template rendering coverage",
+      "real generated project gradle build validation"
+    ]
+  },
+  "operating_assumptions": [
+    "The starter assumes a native Android workstation flow with Gradle, emulator, and release-signing guidance.",
+    "Generated projects should expose bootstrap, doctor, format, build, test, and UI smoke workflows."
+  ],
+  "workflow_labels": ["bootstrap", "doctor", "format", "build", "test", "ui-test", "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": "package_name",
+      "required": true,
+      "prompt": "Android package name: ",
+      "validator": "java-package"
+    },
+    {
+      "name": "application_id",
+      "required": false,
+      "default_from": "package_name",
+      "validator": "java-package"
+    },
+    {
+      "name": "organization_name",
+      "required": false,
+      "default": "Example Team",
+      "validator": "display-name"
+    },
+    {
+      "name": "compile_sdk",
+      "required": false,
+      "default": "35",
+      "validator": "positive-integer",
+      "maximum": 100
+    },
+    {
+      "name": "min_sdk",
+      "required": false,
+      "default": "26",
+      "validator": "positive-integer",
+      "maximum": 100
+    },
+    {
+      "name": "target_sdk",
+      "required": false,
+      "default": "35",
+      "validator": "positive-integer",
+      "maximum": 100
+    },
+    {
+      "name": "version_code",
+      "required": false,
+      "default": "1",
+      "validator": "positive-integer",
+      "maximum": 2100000000
+    },
+    {
+      "name": "version_name",
+      "required": false,
+      "default": "1.0.0",
+      "validator": "semantic-version"
+    },
+    {
+      "name": "java_version",
+      "required": false,
+      "default": "17",
+      "validator": "positive-integer",
+      "minimum": 8,
+      "maximum": 30
+    },
+    {
+      "name": "android_namespace",
+      "required": false,
+      "default_from": "package_name",
+      "validator": "java-package"
+    },
+    {
+      "name": "kotlin_module_name",
+      "required": false,
+      "validator": "identifier"
+    }
+  ],
+  "next_steps": [
+    "make bootstrap",
+    "make doctor",
+    "make format",
+    "make build",
+    "make test",
+    "make test-ui",
+    "open -a \"Android Studio\" ."
+  ]
+}

biucingcli/template_data/apple/template/.gitignore

@@ -0,0 +1,28 @@
+.build
+.bundle
+.cache
+.mise
+DerivedData
+build
+Tuist/.cache
+Tuist/Dependencies
+*.xcodeproj
+*.xcworkspace
+*.xcarchive
+*.ipa
+*.pkg
+xcuserdata
+
+# Local credentials and signing material
+.env
+.env.*
+!.env.example
+/credentials/
+/signing/
+*.p8
+*.p12
+*.pfx
+*.mobileprovision
+*.provisionprofile
+/fastlane/*.json
+/app-store-connect-api-key.json

biucingcli/template_data/apple/template/.mise.toml

@@ -0,0 +1,4 @@
+[tools]
+ruby = "4.0.6"
+node = "24.18.0"
+tuist = "4.202.0"

biucingcli/template_data/apple/template/.swiftformat

@@ -0,0 +1,10 @@
+--swiftversion 6
+--indent 4
+--linebreaks lf
+--disable trailingCommas
+--wraparguments before-first
+--wrapcollections before-first
+--closingparen balanced
+--stripunusedargs closure-only
+--self remove
+--maxwidth 120

biucingcli/template_data/apple/template/.swiftlint.yml

@@ -0,0 +1,33 @@
+included:
+  - App
+  - Packages
+
+excluded:
+  - .build
+  - DerivedData
+
+opt_in_rules:
+  - empty_count
+  - explicit_init
+  - first_where
+  - force_unwrapping
+  - modifier_order
+  - trailing_closure
+
+line_length:
+  warning: 120
+  error: 140
+
+identifier_name:
+  min_length: 2
+  excluded:
+    - id
+
+type_name:
+  min_length: 3
+  max_length:
+    warning: 40
+    error: 50
+
+trailing_whitespace:
+  ignores_empty_lines: true

biucingcli/template_data/apple/template/App/Config/ProjectDescriptionHelpers/Module.swift

@@ -0,0 +1,6 @@
+import ProjectDescription
+
+public enum ModulePath {
+    public static let appServices = "../Packages/AppServices"
+    public static let designSystem = "../Packages/DesignSystem"
+}

biucingcli/template_data/apple/template/App/Config/XCConfig/Base.xcconfig

@@ -0,0 +1,4 @@
+PRODUCT_NAME = $(TARGET_NAME)
+MARKETING_VERSION = 1.0
+CURRENT_PROJECT_VERSION = 1
+SWIFT_STRICT_CONCURRENCY = complete

biucingcli/template_data/apple/template/App/Project.swift

@@ -0,0 +1,66 @@
+import ProjectDescription
+
+let appName = "{{SWIFT_MODULE_NAME}}"
+let debugBundleSuffix = Environment.debugBundleSuffix.getString(default: "")
+
+let project = Project(
+    name: appName,
+    organizationName: "{{ORGANIZATION_NAME}}",
+    packages: [
+        .local(path: "../Packages/AppServices"),
+        .local(path: "../Packages/DesignSystem")
+    ],
+    settings: .settings(
+        base: [
+            "DEVELOPMENT_TEAM": "{{DEVELOPMENT_TEAM}}",
+            "SWIFT_VERSION": "6.0"
+        ]
+    ),
+    targets: [
+        .target(
+            name: appName,
+            destinations: {{TUIST_DESTINATIONS}},
+            product: .app,
+            bundleId: "{{BUNDLE_IDENTIFIER}}\(debugBundleSuffix)",
+            deploymentTargets: {{TUIST_DEPLOYMENT_TARGETS}},
+            infoPlist: .extendingDefault(
+                with: [
+                    "UILaunchScreen": [:],
+                    "CFBundleDisplayName": "{{DISPLAY_NAME}}"
+                ]
+            ),
+            sources: ["Targets/App/Sources/**"],
+            resources: ["Targets/App/Resources/**"],
+            dependencies: [
+                .package(product: "AppServices"),
+                .package(product: "DesignSystem")
+            ]
+        ),
+        .target(
+            name: "\(appName)Tests",
+            destinations: {{TUIST_DESTINATIONS}},
+            product: .unitTests,
+            bundleId: "{{BUNDLE_IDENTIFIER}}\(debugBundleSuffix).tests",
+            infoPlist: .default,
+            sources: ["Targets/AppTests/Sources/**"],
+            dependencies: [
+                .package(product: "AppServices"),
+                .target(name: appName)
+            ]
+        )
+    ],
+    schemes: [
+        .scheme(
+            name: appName,
+            shared: true,
+            buildAction: .buildAction(targets: [.target(appName)]),
+            testAction: .targets(
+                [
+                    .testableTarget(target: .target("\(appName)Tests"))
+                ],
+                options: .options(coverage: true)
+            ),
+            runAction: .runAction(executable: .target(appName))
+        )
+    ]
+)

biucingcli/template_data/apple/template/App/Targets/App/Resources/.gitkeep

@@ -0,0 +1 @@
+

biucingcli/template_data/apple/template/App/Targets/App/Sources/AppEntry.swift

@@ -0,0 +1,9 @@
+import DesignSystem
+import SwiftUI
+
+@main
+struct {{SWIFT_MODULE_NAME}}App: App {
+    var body: some Scene {
+{{APPLE_SCENE_BODY}}
+    }
+}

biucingcli/template_data/apple/template/App/Targets/App/Sources/HomeView.swift

@@ -0,0 +1,18 @@
+import DesignSystem
+import SwiftUI
+
+struct HomeView: View {
+    private let viewModel = HomeViewModel(
+        displayName: "{{DISPLAY_NAME}}",
+        bundleIdentifier: "{{BUNDLE_IDENTIFIER}}",
+        platformName: "{{APPLE_PLATFORM_NAME}}",
+        minimumOSVersion: "{{MINIMUM_OS_VERSION}}",
+        developmentTeam: "{{DEVELOPMENT_TEAM}}"
+    )
+
+{{APPLE_HOME_BODY}}
+}
+
+#Preview {
+    HomeView()
+}

biucingcli/template_data/apple/template/App/Targets/App/Sources/HomeViewModel.swift

@@ -0,0 +1,38 @@
+import AppServices
+import Foundation
+
+typealias HomeFact = StarterFact
+
+struct HomeViewModel {
+    let title: String
+    let subtitle: String
+    let facts: [HomeFact]
+    private let checklistProvider: ReleaseChecklistProviding
+
+    init(
+        displayName: String,
+        bundleIdentifier: String,
+        platformName: String,
+        minimumOSVersion: String,
+        developmentTeam: String,
+        checklistProvider: ReleaseChecklistProviding? = nil
+    ) {
+        title = displayName
+        subtitle = "Tuist-generated starter for Apple platform teams."
+        facts = StarterFactBuilder.overviewFacts(
+            bundleIdentifier: bundleIdentifier,
+            platformName: platformName,
+            minimumOSVersion: minimumOSVersion,
+            developmentTeam: developmentTeam
+        )
+        self.checklistProvider = checklistProvider
+            ?? DefaultReleaseChecklistProvider(
+                bundleIdentifier: bundleIdentifier,
+                developmentTeam: developmentTeam
+            )
+    }
+
+    func releaseChecklist() -> [String] {
+        checklistProvider.releaseChecklistItems()
+    }
+}

biucingcli/template_data/apple/template/App/Targets/AppTests/Sources/AppTests.swift

@@ -0,0 +1,59 @@
+import AppServices
+@testable import {{SWIFT_MODULE_NAME}}
+import XCTest
+
+final class AppTests: XCTestCase {
+    func testHomeViewModelBuildsOverviewFacts() {
+        let viewModel = HomeViewModel(
+            displayName: "Pulse Mac",
+            bundleIdentifier: "com.example.pulsemac",
+            platformName: "macOS",
+            minimumOSVersion: "26.0",
+            developmentTeam: "ABCDE12345"
+        )
+
+        XCTAssertEqual(viewModel.title, "Pulse Mac")
+        XCTAssertEqual(viewModel.subtitle, "Tuist-generated starter for Apple platform teams.")
+        XCTAssertEqual(
+            viewModel.facts,
+            [
+                StarterFact(label: "Bundle ID", systemImage: "shippingbox", value: "com.example.pulsemac"),
+                StarterFact(label: "Platform", systemImage: "app", value: "macOS"),
+                StarterFact(label: "Minimum OS", systemImage: "gear", value: "26.0"),
+                StarterFact(label: "Team", systemImage: "person.3", value: "ABCDE12345")
+            ]
+        )
+    }
+
+    func testHomeViewModelUsesMockChecklistProvider() {
+        let viewModel = HomeViewModel(
+            displayName: "Pulse Mac",
+            bundleIdentifier: "com.example.pulsemac",
+            platformName: "macOS",
+            minimumOSVersion: "26.0",
+            developmentTeam: "ABCDE12345",
+            checklistProvider: MockReleaseChecklistProvider(
+                items: [
+                    "Check beta notes.",
+                    "Share build with QA."
+                ]
+            )
+        )
+
+        XCTAssertEqual(
+            viewModel.releaseChecklist(),
+            [
+                "Check beta notes.",
+                "Share build with QA."
+            ]
+        )
+    }
+}
+
+private struct MockReleaseChecklistProvider: ReleaseChecklistProviding {
+    let items: [String]
+
+    func releaseChecklistItems() -> [String] {
+        items
+    }
+}

biucingcli/template_data/apple/template/Brewfile

@@ -0,0 +1,8 @@
+brew "mise"
+brew "tuist"
+brew "xcodes"
+brew "swiftlint"
+brew "swiftformat"
+brew "xcbeautify"
+brew "fastlane"
+brew "gh"