@topogram/cli 0.3.34

package/src/generator/native/parity-bundle.js

@@ -0,0 +1,311 @@
+import { getExampleImplementation } from "../../example-implementation.js";
+import { getDefaultEnvironmentProjections, resolveRuntimeTopology, runtimeUrls } from "../runtime/shared.js";
+
+/** Pinned toolchains for reproducible native parity stubs (document in README). */
+export const NATIVE_PARITY_PINNED = {
+  gradleDistribution: "8.7",
+  androidGradlePlugin: "8.6.0",
+  kotlin: "1.9.24",
+  compileSdk: 34,
+  minSdk: 26,
+  targetSdk: 34,
+  swiftTools: "5.9",
+  iosDeploymentMajor: 17,
+  macOSCompanionMajor: 14
+};
+
+const ANDROID_PACKAGE = "io.topogram.nativeparity";
+
+function escapeKotlinString(value) {
+  return String(value ?? "")
+    .replace(/\\/g, "\\\\")
+    .replace(/"/g, '\\"');
+}
+
+function escapeSwiftString(value) {
+  return String(value ?? "")
+    .replace(/\\/g, "\\\\")
+    .replace(/"/g, '\\"');
+}
+
+function buildNativeParityPlan(graph, options = {}) {
+  const runtimeReference = getExampleImplementation(graph, options).runtime.reference;
+  const topology = resolveRuntimeTopology(graph, options);
+  const { apiProjection, uiProjection, dbProjection } = getDefaultEnvironmentProjections(graph, options);
+  const urls = runtimeUrls(runtimeReference, topology);
+  const demoUserId = runtimeReference.demoEnv?.userId ?? null;
+
+  return {
+    type: "native_parity_plan",
+    name: "native_parity_plan",
+    projections: {
+      api: apiProjection.id,
+      ui: uiProjection.id,
+      db: dbProjection.id
+    },
+    pinned_toolchains: { ...NATIVE_PARITY_PINNED },
+    resolved_urls: {
+      PUBLIC_TOPOGRAM_API_BASE_URL: urls.api,
+      PUBLIC_TOPOGRAM_WEB_BASE_URL: urls.web
+    },
+    demo_user_id: demoUserId,
+    android: {
+      package: ANDROID_PACKAGE,
+      application_id: ANDROID_PACKAGE
+    },
+    ios: {
+      module: "TopogramNativeParity",
+      swift_tools_version: NATIVE_PARITY_PINNED.swiftTools
+    }
+  };
+}
+
+function renderRootReadme(plan, urls) {
+  const demoOpsUrl =
+    "https://github.com/attebury/topogram/blob/main/docs/README.md";
+  return `# Native parity bundle
+
+Minimal **Android (Gradle/Kotlin)** and **iOS (Swift Package / SwiftUI)** stubs wired to the same runtime URL metadata as other Topogram bundles.
+
+## Resolved URLs (from workspace)
+
+- **API:** \`${urls.api}\`
+- **Web:** \`${urls.web}\`
+
+Plan metadata: \`native-parity-plan.json\`.
+
+## Android (\`android/\`)
+
+Pinned AGP **${plan.pinned_toolchains.androidGradlePlugin}**, Kotlin **${plan.pinned_toolchains.kotlin}**, compile/target SDK **${plan.pinned_toolchains.compileSdk}**.
+
+If \`gradlew\` is not present, generate the wrapper once (requires a local Gradle install):
+
+\`\`\`bash
+cd android
+gradle wrapper --gradle-version ${plan.pinned_toolchains.gradleDistribution}
+./gradlew assembleDebug
+\`\`\`
+
+## iOS (\`ios/\`)
+
+Swift tools **${plan.pinned_toolchains.swiftTools}**, iOS **${plan.pinned_toolchains.iosDeploymentMajor}+** (Swift Package).
+
+Open \`Package.swift\` in Xcode or build on macOS:
+
+\`\`\`bash
+cd ios
+swift build
+\`\`\`
+
+(\`swift build\` requires Swift; iOS-only SwiftUI may require Xcode for simulator/device builds.)
+
+## Promotion
+
+Native parity promotion is deferred while the active docs focus on generated app demos. See [Topogram docs](${demoOpsUrl}).
+`;
+}
+
+function renderAndroidFiles(plan, apiUrl) {
+  const kotlinApi = escapeKotlinString(apiUrl);
+
+  return {
+    "android/settings.gradle.kts": `pluginManagement {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+rootProject.name = "TopogramNativeParity"
+include(":app")
+`,
+    "android/build.gradle.kts": `plugins {
+    alias(libs.plugins.android.application) apply false
+    alias(libs.plugins.kotlin.android) apply false
+}
+`,
+    "android/gradle.properties": `org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+android.useAndroidX=true
+android.nonTransitiveRClass=true
+kotlin.code.style=official
+`,
+    "android/gradle/libs.versions.toml": `[versions]
+agp = "${plan.pinned_toolchains.androidGradlePlugin}"
+kotlin = "${plan.pinned_toolchains.kotlin}"
+compileSdk = "${plan.pinned_toolchains.compileSdk}"
+minSdk = "${plan.pinned_toolchains.minSdk}"
+targetSdk = "${plan.pinned_toolchains.targetSdk}"
+appcompat = "1.6.1"
+
+[libraries]
+androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
+
+[plugins]
+android-application = { id = "com.android.application", version.ref = "agp" }
+kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
+`,
+    "android/gradle/wrapper/gradle-wrapper.properties": `distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\\://services.gradle.org/distributions/gradle-${plan.pinned_toolchains.gradleDistribution}-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+`,
+    "android/app/build.gradle.kts": `plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.kotlin.android)
+}
+
+android {
+    namespace = "${ANDROID_PACKAGE}"
+    compileSdk = libs.versions.compileSdk.get().toInt()
+
+    defaultConfig {
+        applicationId = "${ANDROID_PACKAGE}"
+        minSdk = libs.versions.minSdk.get().toInt()
+        targetSdk = libs.versions.targetSdk.get().toInt()
+        versionCode = 1
+        versionName = "1.0"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+        }
+    }
+
+    kotlinOptions {
+        jvmTarget = "17"
+    }
+}
+
+dependencies {
+    implementation(libs.androidx.appcompat)
+}
+`,
+    [`android/app/src/main/java/${ANDROID_PACKAGE.replaceAll(".", "/")}/ParityConfig.kt`]: `package ${ANDROID_PACKAGE}
+
+/**
+ * Resolved from Topogram native-parity bundle generation (matches runtimeUrls.api).
+ */
+object ParityConfig {
+    const val API_BASE_URL: String = "${kotlinApi}"
+}
+`,
+    [`android/app/src/main/java/${ANDROID_PACKAGE.replaceAll(".", "/")}/MainActivity.kt`]: `package ${ANDROID_PACKAGE}
+
+import android.os.Bundle
+import android.widget.TextView
+import androidx.appcompat.app.AppCompatActivity
+
+class MainActivity : AppCompatActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        val label = TextView(this).apply {
+            text = ParityConfig.API_BASE_URL
+            textSize = 14f
+            setPadding(32, 32, 32, 32)
+        }
+        setContentView(label)
+    }
+}
+`,
+    "android/app/src/main/AndroidManifest.xml": `<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="true"
+        android:label="Topogram parity"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.AppCompat.Light.NoActionBar">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>
+`
+  };
+}
+
+function renderIosFiles(plan, apiUrl) {
+  const swiftApi = escapeSwiftString(apiUrl);
+  const iosMajor = plan.pinned_toolchains.iosDeploymentMajor;
+  const macMajor = plan.pinned_toolchains.macOSCompanionMajor;
+  // Platforms use Swift literal suffixes .v17 — templating `${iosMajor}` yields `.v17`.
+
+  return {
+    "ios/Package.swift": `// swift-tools-version: ${plan.pinned_toolchains.swiftTools}
+import PackageDescription
+
+let package = Package(
+    name: "TopogramNativeParity",
+    platforms: [.iOS(.v${iosMajor}), .macOS(.v${macMajor})],
+    products: [
+        .library(name: "TopogramNativeParity", targets: ["TopogramNativeParity"])
+    ],
+    targets: [
+        .target(
+            name: "TopogramNativeParity",
+            path: "Sources/TopogramNativeParity"
+        )
+    ]
+)
+`,
+    "ios/Sources/TopogramNativeParity/ParityConfig.swift": `import Foundation
+
+public enum ParityConfig {
+    /// Resolved from Topogram runtimeUrls at generation time.
+    public static let apiBaseURL: URL = URL(string: "${swiftApi}")!
+}
+`,
+    "ios/Sources/TopogramNativeParity/ParityRootView.swift": `import SwiftUI
+
+public struct ParityRootView: View {
+    public init() {}
+
+    public var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            Text("Topogram native parity stub")
+                .font(.headline)
+            Text(ParityConfig.apiBaseURL.absoluteString)
+                .font(.footnote)
+                .textSelection(.enabled)
+        }
+        .padding()
+    }
+}
+`
+  };
+}
+
+export function generateNativeParityPlan(graph, options = {}) {
+  return buildNativeParityPlan(graph, options);
+}
+
+export function generateNativeParityBundle(graph, options = {}) {
+  const plan = buildNativeParityPlan(graph, options);
+  const runtimeReference = getExampleImplementation(graph, options).runtime.reference;
+  const urls = runtimeUrls(runtimeReference, resolveRuntimeTopology(graph, options));
+
+  return {
+    "native-parity-plan.json": `${JSON.stringify(plan, null, 2)}\n`,
+    "README.md": renderRootReadme(plan, urls),
+    ...renderAndroidFiles(plan, urls.api),
+    ...renderIosFiles(plan, urls.api)
+  };
+}

package/src/generator/output.js

@@ -0,0 +1,300 @@
+export function buildOutputFiles(result, options = {}) {
+  if (result.target === "context-digest") {
+    return Object.keys(result.artifact)
+      .sort()
+      .map((filePath) => ({
+        path: filePath,
+        contents: result.artifact[filePath]
+      }));
+  }
+
+  if (result.target === "context-diff") {
+    return [{ path: "context-diff.json", contents: result.artifact }];
+  }
+
+  if (result.target === "context-slice") {
+    const sliceId =
+      options.capabilityId || options.projectionId || options.entityId || options.journeyId || options.workflowId || "context";
+    return [{ path: `${sliceId}.context-slice.json`, contents: result.artifact }];
+  }
+
+  if (result.target === "context-bundle") {
+    const files = [{ path: `context-bundle.${options.taskId || "bundle"}.json`, contents: result.artifact }];
+    if (options.taskId === "maintained-app" && result.artifact?.maintained_boundary) {
+      files.push({ path: "maintained-boundary.json", contents: result.artifact.maintained_boundary });
+    }
+    return files;
+  }
+
+  if (result.target === "context-report") {
+    return [{ path: "context-report.json", contents: result.artifact }];
+  }
+
+  if (result.target === "context-task-mode") {
+    return [{ path: `${options.modeId || "task-mode"}.context-task-mode.json`, contents: result.artifact }];
+  }
+
+  if (result.target === "openapi") {
+    return [
+      {
+        path: options.capabilityId ? `${options.capabilityId}.openapi.json` : "openapi.json",
+        contents: result.artifact
+      }
+    ];
+  }
+
+  if (result.target === "api-contract-debug") {
+    return [
+      {
+        path: options.capabilityId ? `${options.capabilityId}.api-contract-debug.md` : "api-contract-debug.md",
+        contents: result.artifact
+      }
+    ];
+  }
+
+  if (result.target === "ui-contract-debug") {
+    return [
+      {
+        path: options.projectionId ? `${options.projectionId}.ui-contract-debug.md` : "ui-contract-debug.md",
+        contents: result.artifact
+      }
+    ];
+  }
+
+  if (result.target === "api-contract-graph") {
+    if (options.capabilityId) {
+      return [{ path: `${options.capabilityId}.api-contract-graph.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((capabilityId) => ({
+      path: `${capabilityId}.api-contract-graph.json`,
+      contents: result.artifact[capabilityId]
+    }));
+  }
+
+  if (result.target === "ui-contract-graph") {
+    if (options.projectionId) {
+      return [{ path: `${options.projectionId}.ui-contract-graph.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((projectionId) => ({
+      path: `${projectionId}.ui-contract-graph.json`,
+      contents: result.artifact[projectionId]
+    }));
+  }
+
+  if (result.target === "ui-component-contract") {
+    if (result.artifact == null) {
+      throw new Error("ui-component-contract generator returned no artifact");
+    }
+    if (options.componentId) {
+      return [{ path: `${options.componentId}.ui-component-contract.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((componentId) => ({
+      path: `${componentId}.ui-component-contract.json`,
+      contents: result.artifact[componentId]
+    }));
+  }
+
+  if (result.target === "component-conformance-report") {
+    const suffix = [options.projectionId, options.componentId].filter(Boolean).join(".");
+    return [{
+      path: suffix
+        ? `${suffix}.component-conformance-report.json`
+        : "component-conformance-report.json",
+      contents: result.artifact
+    }];
+  }
+
+  if (result.target === "component-behavior-report") {
+    const suffix = [options.projectionId, options.componentId].filter(Boolean).join(".");
+    return [{
+      path: suffix
+        ? `${suffix}.component-behavior-report.json`
+        : "component-behavior-report.json",
+      contents: result.artifact
+    }];
+  }
+
+  if (result.target === "ui-web-debug") {
+    return [
+      {
+        path: options.projectionId ? `${options.projectionId}.ui-web-debug.md` : "ui-web-debug.md",
+        contents: result.artifact
+      }
+    ];
+  }
+
+  if (result.target === "ui-web-contract") {
+    if (options.projectionId) {
+      return [{ path: `${options.projectionId}.ui-web-contract.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((projectionId) => ({
+      path: `${projectionId}.ui-web-contract.json`,
+      contents: result.artifact[projectionId]
+    }));
+  }
+
+  if (
+    result.target === "sveltekit-app" ||
+    result.target === "swiftui-app" ||
+    result.target === "db-lifecycle-bundle" ||
+    result.target === "environment-bundle" ||
+    result.target === "deployment-bundle" ||
+    result.target === "runtime-smoke-bundle" ||
+    result.target === "runtime-check-bundle" ||
+    result.target === "compile-check-bundle" ||
+    result.target === "app-bundle" ||
+    result.target === "persistence-scaffold" ||
+    result.target === "hono-server" ||
+    result.target === "express-server"
+  ) {
+    return Object.keys(result.artifact)
+      .sort()
+      .map((filePath) => ({
+        path: filePath,
+        contents: result.artifact[filePath]
+      }));
+  }
+
+  if (result.target === "db-contract-debug") {
+    return [
+      {
+        path: options.projectionId ? `${options.projectionId}.db-contract-debug.md` : "db-contract-debug.md",
+        contents: result.artifact
+      }
+    ];
+  }
+
+  if (result.target === "db-contract-graph") {
+    if (options.projectionId) {
+      return [{ path: `${options.projectionId}.db-contract-graph.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((projectionId) => ({
+      path: `${projectionId}.db-contract-graph.json`,
+      contents: result.artifact[projectionId]
+    }));
+  }
+
+  if (result.target === "db-schema-snapshot") {
+    if (options.projectionId) {
+      return [{ path: `${options.projectionId}.db-schema-snapshot.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((projectionId) => ({
+      path: `${projectionId}.db-schema-snapshot.json`,
+      contents: result.artifact[projectionId]
+    }));
+  }
+
+  if (result.target === "db-migration-plan") {
+    return [
+      {
+        path: options.projectionId ? `${options.projectionId}.db-migration-plan.json` : "db-migration-plan.json",
+        contents: result.artifact
+      }
+    ];
+  }
+
+  if (result.target === "db-lifecycle-plan") {
+    if (options.projectionId) {
+      return [{ path: `${options.projectionId}.db-lifecycle-plan.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((projectionId) => ({
+      path: `${projectionId}.db-lifecycle-plan.json`,
+      contents: result.artifact[projectionId]
+    }));
+  }
+
+  if (result.target === "sql-schema") {
+    return [{ path: options.projectionId ? `${options.projectionId}.sql` : "schema.sql", contents: result.artifact }];
+  }
+
+  if (result.target === "sql-migration") {
+    return [{ path: options.projectionId ? `${options.projectionId}.migration.sql` : "migration.sql", contents: result.artifact }];
+  }
+
+  if (result.target === "environment-plan") {
+    return [{ path: "environment-plan.json", contents: result.artifact }];
+  }
+
+  if (result.target === "deployment-plan") {
+    return [{ path: options.profileId ? `deployment-plan.${options.profileId}.json` : "deployment-plan.json", contents: result.artifact }];
+  }
+
+  if (result.target === "runtime-smoke-plan") {
+    return [{ path: "runtime-smoke-plan.json", contents: result.artifact }];
+  }
+
+  if (result.target === "runtime-check-plan") {
+    return [{ path: "runtime-check-plan.json", contents: result.artifact }];
+  }
+
+  if (result.target === "compile-check-plan") {
+    return [{ path: "compile-check-plan.json", contents: result.artifact }];
+  }
+
+  if (result.target === "app-bundle-plan") {
+    return [{ path: "app-bundle-plan.json", contents: result.artifact }];
+  }
+
+  if (result.target === "prisma-schema") {
+    return [{ path: "schema.prisma", contents: result.artifact }];
+  }
+
+  if (result.target === "drizzle-schema") {
+    return [{ path: options.projectionId ? `${options.projectionId}.drizzle.ts` : "schema.ts", contents: result.artifact }];
+  }
+
+  if (result.target === "server-contract") {
+    if (options.projectionId) {
+      return [{ path: `${options.projectionId}.server-contract.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((projectionId) => ({
+      path: `${projectionId}.server-contract.json`,
+      contents: result.artifact[projectionId]
+    }));
+  }
+
+  if (result.target === "shape-transform-debug") {
+    return [{ path: options.shapeId ? `${options.shapeId}.transform-debug.md` : "shape-transform-debug.md", contents: result.artifact }];
+  }
+
+  if (result.target === "shape-transform-graph") {
+    if (options.shapeId) {
+      return [{ path: `${options.shapeId}.transform-graph.json`, contents: result.artifact }];
+    }
+    return Object.keys(result.artifact).sort().map((shapeId) => ({
+      path: `${shapeId}.transform-graph.json`,
+      contents: result.artifact[shapeId]
+    }));
+  }
+
+  if (result.target === "docs") {
+    return [{ path: "topogram-docs.md", contents: result.artifact }];
+  }
+
+  if (result.target === "docs-index") {
+    return [{ path: "docs-index.json", contents: result.artifact }];
+  }
+
+  if (result.target === "verification-plan") {
+    return [{ path: "verification-plan.json", contents: result.artifact }];
+  }
+
+  if (result.target === "verification-checklist") {
+    return [{ path: "verification-checklist.md", contents: result.artifact }];
+  }
+
+  if (result.target !== "json-schema") {
+    throw new Error(`Unsupported file output target '${result.target}'`);
+  }
+
+  if (options.shapeId) {
+    return [{ path: `${options.shapeId}.schema.json`, contents: result.artifact }];
+  }
+
+  return Object.keys(result.artifact)
+    .sort()
+    .map((shapeId) => ({
+      path: `${shapeId}.schema.json`,
+      contents: result.artifact[shapeId]
+    }));
+}