Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
00195e9f14 | ||
|
|
3d133cbd14 | ||
|
|
83ae18a17f | ||
|
|
a0a051c10a | ||
|
|
b67192a08b | ||
|
|
2f1bba5e4c | ||
|
|
ec75875f0d | ||
|
|
a61c1a1342 | ||
|
|
75791f5861 | ||
|
|
7474b1c71d | ||
|
|
2cfdd9f437 | ||
|
|
26ad924565 | ||
|
|
86e544ea2e | ||
|
|
4bbc341bcb | ||
|
|
52c40bd3e3 | ||
|
|
bd6c7094b1 | ||
|
|
361efaa1d6 | ||
|
|
0f774f13b3 | ||
|
|
974c2651bf | ||
|
|
c9c901c7f2 | ||
|
|
8e448c26f2 | ||
|
|
4a4941c6ff | ||
|
|
6bd2dab74b | ||
|
|
4657a58800 | ||
|
|
df6bd04042 | ||
|
|
482de6ce3c | ||
|
|
5a83d34c59 | ||
|
|
a0bd095c4e | ||
|
|
b5c90d2dc1 | ||
|
|
ae50e62535 | ||
|
|
feae445f5a | ||
|
|
e7e51aecdb | ||
|
|
6fb9a2e8b4 | ||
|
|
b2ec917af4 | ||
|
|
c1a1325564 | ||
|
|
2e7b05bdad | ||
|
|
53d30e5cae | ||
|
|
7390a17a91 | ||
|
|
f507b0eaed |
@@ -0,0 +1,101 @@
|
||||
# Using Android gitignore template: https://github.com/github/gitignore/blob/HEAD/Android.gitignore
|
||||
|
||||
# Built application files
|
||||
*.apk
|
||||
*.aar
|
||||
*.ap_
|
||||
*.aab
|
||||
|
||||
# Files for the ART/Dalvik VM
|
||||
*.dex
|
||||
|
||||
# Java class files
|
||||
*.class
|
||||
|
||||
# Generated files
|
||||
bin/
|
||||
gen/
|
||||
out/
|
||||
# Uncomment the following line in case you need and you don't have the release build type files in your app
|
||||
# release/
|
||||
|
||||
# Gradle files
|
||||
.gradle/
|
||||
build/
|
||||
|
||||
# Local configuration file (sdk path, etc)
|
||||
local.properties
|
||||
|
||||
# Proguard folder generated by Eclipse
|
||||
proguard/
|
||||
|
||||
# Log Files
|
||||
*.log
|
||||
|
||||
# Android Studio Navigation editor temp files
|
||||
.navigation/
|
||||
|
||||
# Android Studio captures folder
|
||||
captures/
|
||||
|
||||
# IntelliJ
|
||||
*.iml
|
||||
.idea/workspace.xml
|
||||
.idea/tasks.xml
|
||||
.idea/gradle.xml
|
||||
.idea/assetWizardSettings.xml
|
||||
.idea/dictionaries
|
||||
.idea/libraries
|
||||
# Android Studio 3 in .gitignore file.
|
||||
.idea/caches
|
||||
.idea/modules.xml
|
||||
# Comment next line if keeping position of elements in Navigation Editor is relevant for you
|
||||
.idea/navEditor.xml
|
||||
|
||||
# Keystore files
|
||||
# Uncomment the following lines if you do not want to check your keystore files in.
|
||||
#*.jks
|
||||
#*.keystore
|
||||
|
||||
# External native build folder generated in Android Studio 2.2 and later
|
||||
.externalNativeBuild
|
||||
.cxx/
|
||||
|
||||
# Google Services (e.g. APIs or Firebase)
|
||||
# google-services.json
|
||||
|
||||
# Freeline
|
||||
freeline.py
|
||||
freeline/
|
||||
freeline_project_description.json
|
||||
|
||||
# fastlane
|
||||
fastlane/report.xml
|
||||
fastlane/Preview.html
|
||||
fastlane/screenshots
|
||||
fastlane/test_output
|
||||
fastlane/readme.md
|
||||
|
||||
# Version control
|
||||
vcs.xml
|
||||
|
||||
# lint
|
||||
lint/intermediates/
|
||||
lint/generated/
|
||||
lint/outputs/
|
||||
lint/tmp/
|
||||
# lint/reports/
|
||||
|
||||
# Android Profiling
|
||||
*.hprof
|
||||
|
||||
# Cordova plugins for Capacitor
|
||||
capacitor-cordova-android-plugins
|
||||
|
||||
# Copied web assets
|
||||
app/src/main/assets/public
|
||||
|
||||
# Generated Config files
|
||||
app/src/main/assets/capacitor.config.json
|
||||
app/src/main/assets/capacitor.plugins.json
|
||||
app/src/main/res/xml/config.xml
|
||||
@@ -0,0 +1,2 @@
|
||||
/build/*
|
||||
!/build/.npmkeep
|
||||
@@ -0,0 +1,54 @@
|
||||
apply plugin: 'com.android.application'
|
||||
|
||||
android {
|
||||
namespace "dev.eom.wikideck"
|
||||
compileSdk rootProject.ext.compileSdkVersion
|
||||
defaultConfig {
|
||||
applicationId "dev.eom.wikideck"
|
||||
minSdkVersion rootProject.ext.minSdkVersion
|
||||
targetSdkVersion rootProject.ext.targetSdkVersion
|
||||
versionCode 1
|
||||
versionName "1.0"
|
||||
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
|
||||
aaptOptions {
|
||||
// Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
|
||||
// Default: https://android.googlesource.com/platform/frameworks/base/+/282e181b58cf72b6ca770dc7ca5f91f135444502/tools/aapt/AaptAssets.cpp#61
|
||||
ignoreAssetsPattern '!.svn:!.git:!.ds_store:!*.scc:.*:!CVS:!thumbs.db:!picasa.ini:!*~'
|
||||
}
|
||||
}
|
||||
buildTypes {
|
||||
release {
|
||||
minifyEnabled false
|
||||
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
repositories {
|
||||
flatDir{
|
||||
dirs '../capacitor-cordova-android-plugins/src/main/libs', 'libs'
|
||||
}
|
||||
}
|
||||
|
||||
dependencies {
|
||||
implementation fileTree(include: ['*.jar'], dir: 'libs')
|
||||
implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
|
||||
implementation "androidx.coordinatorlayout:coordinatorlayout:$androidxCoordinatorLayoutVersion"
|
||||
implementation "androidx.core:core-splashscreen:$coreSplashScreenVersion"
|
||||
implementation project(':capacitor-android')
|
||||
testImplementation "junit:junit:$junitVersion"
|
||||
androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
|
||||
androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
|
||||
implementation project(':capacitor-cordova-android-plugins')
|
||||
}
|
||||
|
||||
apply from: 'capacitor.build.gradle'
|
||||
|
||||
try {
|
||||
def servicesJSON = file('google-services.json')
|
||||
if (servicesJSON.text) {
|
||||
apply plugin: 'com.google.gms.google-services'
|
||||
}
|
||||
} catch(Exception e) {
|
||||
logger.info("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
|
||||
}
|
||||
@@ -0,0 +1,20 @@
|
||||
// DO NOT EDIT THIS FILE! IT IS GENERATED EACH TIME "capacitor update" IS RUN
|
||||
|
||||
android {
|
||||
compileOptions {
|
||||
sourceCompatibility JavaVersion.VERSION_21
|
||||
targetCompatibility JavaVersion.VERSION_21
|
||||
}
|
||||
}
|
||||
|
||||
apply from: "../capacitor-cordova-android-plugins/cordova.variables.gradle"
|
||||
dependencies {
|
||||
implementation project(':capacitor-app')
|
||||
implementation project(':capacitor-browser')
|
||||
|
||||
}
|
||||
|
||||
|
||||
if (hasProperty('postBuildExtras')) {
|
||||
postBuildExtras()
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
# Add project specific ProGuard rules here.
|
||||
# You can control the set of applied configuration files using the
|
||||
# proguardFiles setting in build.gradle.
|
||||
#
|
||||
# For more details, see
|
||||
# http://developer.android.com/guide/developing/tools/proguard.html
|
||||
|
||||
# If your project uses WebView with JS, uncomment the following
|
||||
# and specify the fully qualified class name to the JavaScript interface
|
||||
# class:
|
||||
#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
|
||||
# public *;
|
||||
#}
|
||||
|
||||
# Uncomment this to preserve the line number information for
|
||||
# debugging stack traces.
|
||||
#-keepattributes SourceFile,LineNumberTable
|
||||
|
||||
# If you keep the line number information, uncomment this to
|
||||
# hide the original source file name.
|
||||
#-renamesourcefileattribute SourceFile
|
||||
@@ -0,0 +1,26 @@
|
||||
package com.getcapacitor.myapp;
|
||||
|
||||
import static org.junit.Assert.*;
|
||||
|
||||
import android.content.Context;
|
||||
import androidx.test.ext.junit.runners.AndroidJUnit4;
|
||||
import androidx.test.platform.app.InstrumentationRegistry;
|
||||
import org.junit.Test;
|
||||
import org.junit.runner.RunWith;
|
||||
|
||||
/**
|
||||
* Instrumented test, which will execute on an Android device.
|
||||
*
|
||||
* @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
|
||||
*/
|
||||
@RunWith(AndroidJUnit4.class)
|
||||
public class ExampleInstrumentedTest {
|
||||
|
||||
@Test
|
||||
public void useAppContext() throws Exception {
|
||||
// Context of the app under test.
|
||||
Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
|
||||
|
||||
assertEquals("com.getcapacitor.app", appContext.getPackageName());
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,51 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
|
||||
|
||||
<application
|
||||
android:allowBackup="true"
|
||||
android:icon="@mipmap/ic_launcher"
|
||||
android:label="@string/app_name"
|
||||
android:roundIcon="@mipmap/ic_launcher_round"
|
||||
android:supportsRtl="true"
|
||||
android:usesCleartextTraffic="true"
|
||||
android:theme="@style/AppTheme">
|
||||
|
||||
<activity
|
||||
android:windowSoftInputMode="adjustResize"
|
||||
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode|navigation"
|
||||
android:name=".MainActivity"
|
||||
android:label="@string/title_activity_main"
|
||||
android:theme="@style/AppTheme.NoActionBarLaunch"
|
||||
android:launchMode="singleTask"
|
||||
android:exported="true">
|
||||
|
||||
<intent-filter>
|
||||
<action android:name="android.intent.action.MAIN" />
|
||||
<category android:name="android.intent.category.LAUNCHER" />
|
||||
</intent-filter>
|
||||
|
||||
<!-- SSO redirect (RFC 8252 private-use scheme, registered with Dex as dev.eom.wikideck:/oauth/callback) -->
|
||||
<intent-filter>
|
||||
<action android:name="android.intent.action.VIEW" />
|
||||
<category android:name="android.intent.category.DEFAULT" />
|
||||
<category android:name="android.intent.category.BROWSABLE" />
|
||||
<data android:scheme="dev.eom.wikideck" />
|
||||
</intent-filter>
|
||||
|
||||
</activity>
|
||||
|
||||
<provider
|
||||
android:name="androidx.core.content.FileProvider"
|
||||
android:authorities="${applicationId}.fileprovider"
|
||||
android:exported="false"
|
||||
android:grantUriPermissions="true">
|
||||
<meta-data
|
||||
android:name="android.support.FILE_PROVIDER_PATHS"
|
||||
android:resource="@xml/file_paths"></meta-data>
|
||||
</provider>
|
||||
</application>
|
||||
|
||||
<!-- Permissions -->
|
||||
|
||||
<uses-permission android:name="android.permission.INTERNET" />
|
||||
</manifest>
|
||||
@@ -0,0 +1,5 @@
|
||||
package dev.eom.wikideck;
|
||||
|
||||
import com.getcapacitor.BridgeActivity;
|
||||
|
||||
public class MainActivity extends BridgeActivity {}
|
||||
|
After Width: | Height: | Size: 7.5 KiB |
|
After Width: | Height: | Size: 3.9 KiB |
|
After Width: | Height: | Size: 9.0 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 7.7 KiB |
|
After Width: | Height: | Size: 4.0 KiB |
|
After Width: | Height: | Size: 9.6 KiB |
|
After Width: | Height: | Size: 13 KiB |
|
After Width: | Height: | Size: 17 KiB |
@@ -0,0 +1,34 @@
|
||||
<vector xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
xmlns:aapt="http://schemas.android.com/aapt"
|
||||
android:width="108dp"
|
||||
android:height="108dp"
|
||||
android:viewportHeight="108"
|
||||
android:viewportWidth="108">
|
||||
<path
|
||||
android:fillType="evenOdd"
|
||||
android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
|
||||
android:strokeColor="#00000000"
|
||||
android:strokeWidth="1">
|
||||
<aapt:attr name="android:fillColor">
|
||||
<gradient
|
||||
android:endX="78.5885"
|
||||
android:endY="90.9159"
|
||||
android:startX="48.7653"
|
||||
android:startY="61.0927"
|
||||
android:type="linear">
|
||||
<item
|
||||
android:color="#44000000"
|
||||
android:offset="0.0" />
|
||||
<item
|
||||
android:color="#00000000"
|
||||
android:offset="1.0" />
|
||||
</gradient>
|
||||
</aapt:attr>
|
||||
</path>
|
||||
<path
|
||||
android:fillColor="#FFFFFF"
|
||||
android:fillType="nonZero"
|
||||
android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
|
||||
android:strokeColor="#00000000"
|
||||
android:strokeWidth="1" />
|
||||
</vector>
|
||||
@@ -0,0 +1,170 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<vector xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
android:width="108dp"
|
||||
android:height="108dp"
|
||||
android:viewportHeight="108"
|
||||
android:viewportWidth="108">
|
||||
<path
|
||||
android:fillColor="#26A69A"
|
||||
android:pathData="M0,0h108v108h-108z" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M9,0L9,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M19,0L19,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M29,0L29,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M39,0L39,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M49,0L49,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M59,0L59,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M69,0L69,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M79,0L79,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M89,0L89,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M99,0L99,108"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,9L108,9"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,19L108,19"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,29L108,29"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,39L108,39"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,49L108,49"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,59L108,59"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,69L108,69"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,79L108,79"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,89L108,89"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M0,99L108,99"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M19,29L89,29"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M19,39L89,39"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M19,49L89,49"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M19,59L89,59"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M19,69L89,69"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M19,79L89,79"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M29,19L29,89"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M39,19L39,89"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M49,19L49,89"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M59,19L59,89"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M69,19L69,89"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
<path
|
||||
android:fillColor="#00000000"
|
||||
android:pathData="M79,19L79,89"
|
||||
android:strokeColor="#33FFFFFF"
|
||||
android:strokeWidth="0.8" />
|
||||
</vector>
|
||||
|
After Width: | Height: | Size: 3.9 KiB |
@@ -0,0 +1,12 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
xmlns:app="http://schemas.android.com/apk/res-auto"
|
||||
xmlns:tools="http://schemas.android.com/tools"
|
||||
android:layout_width="match_parent"
|
||||
android:layout_height="match_parent"
|
||||
tools:context=".MainActivity">
|
||||
|
||||
<WebView
|
||||
android:layout_width="match_parent"
|
||||
android:layout_height="match_parent" />
|
||||
</androidx.coordinatorlayout.widget.CoordinatorLayout>
|
||||
@@ -0,0 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
|
||||
<background android:drawable="@color/ic_launcher_background"/>
|
||||
<foreground android:drawable="@mipmap/ic_launcher_foreground"/>
|
||||
</adaptive-icon>
|
||||
@@ -0,0 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
|
||||
<background android:drawable="@color/ic_launcher_background"/>
|
||||
<foreground android:drawable="@mipmap/ic_launcher_foreground"/>
|
||||
</adaptive-icon>
|
||||
|
After Width: | Height: | Size: 2.7 KiB |
|
After Width: | Height: | Size: 3.4 KiB |
|
After Width: | Height: | Size: 4.2 KiB |
|
After Width: | Height: | Size: 1.8 KiB |
|
After Width: | Height: | Size: 2.1 KiB |
|
After Width: | Height: | Size: 2.7 KiB |
|
After Width: | Height: | Size: 3.9 KiB |
|
After Width: | Height: | Size: 4.9 KiB |
|
After Width: | Height: | Size: 6.4 KiB |
|
After Width: | Height: | Size: 6.5 KiB |
|
After Width: | Height: | Size: 9.6 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 9.2 KiB |
|
After Width: | Height: | Size: 15 KiB |
|
After Width: | Height: | Size: 16 KiB |
@@ -0,0 +1,8 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<resources>
|
||||
<color name="colorPrimary">#1e1e2e</color>
|
||||
<color name="colorPrimaryDark">#11111b</color>
|
||||
<color name="colorAccent">#cba6f7</color>
|
||||
<!-- Behind the status and navigation bars: matches the dark app header. -->
|
||||
<color name="wikideckChrome">#11111b</color>
|
||||
</resources>
|
||||
@@ -0,0 +1,4 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<resources>
|
||||
<color name="ic_launcher_background">#FFFFFF</color>
|
||||
</resources>
|
||||
@@ -0,0 +1,7 @@
|
||||
<?xml version='1.0' encoding='utf-8'?>
|
||||
<resources>
|
||||
<string name="app_name">WikiDeck</string>
|
||||
<string name="title_activity_main">WikiDeck</string>
|
||||
<string name="package_name">dev.eom.wikideck</string>
|
||||
<string name="custom_url_scheme">dev.eom.wikideck</string>
|
||||
</resources>
|
||||
@@ -0,0 +1,25 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<resources>
|
||||
|
||||
<!-- Base application theme. -->
|
||||
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
|
||||
<!-- Customize your theme here. -->
|
||||
<item name="colorPrimary">@color/colorPrimary</item>
|
||||
<item name="colorPrimaryDark">@color/colorPrimaryDark</item>
|
||||
<item name="colorAccent">@color/colorAccent</item>
|
||||
</style>
|
||||
|
||||
<style name="AppTheme.NoActionBar" parent="Theme.AppCompat.DayNight.NoActionBar">
|
||||
<item name="windowActionBar">false</item>
|
||||
<item name="windowNoTitle">true</item>
|
||||
<item name="android:background">@null</item>
|
||||
<!-- Dark behind the status/navigation bars (edge-to-edge margins) to match the app chrome. -->
|
||||
<item name="android:windowBackground">@color/wikideckChrome</item>
|
||||
<item name="android:windowLightStatusBar">false</item>
|
||||
</style>
|
||||
|
||||
|
||||
<style name="AppTheme.NoActionBarLaunch" parent="Theme.SplashScreen">
|
||||
<item name="android:background">@drawable/splash</item>
|
||||
</style>
|
||||
</resources>
|
||||
@@ -0,0 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<paths xmlns:android="http://schemas.android.com/apk/res/android">
|
||||
<external-path name="my_images" path="." />
|
||||
<cache-path name="my_cache_images" path="." />
|
||||
</paths>
|
||||
@@ -0,0 +1,18 @@
|
||||
package com.getcapacitor.myapp;
|
||||
|
||||
import static org.junit.Assert.*;
|
||||
|
||||
import org.junit.Test;
|
||||
|
||||
/**
|
||||
* Example local unit test, which will execute on the development machine (host).
|
||||
*
|
||||
* @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
|
||||
*/
|
||||
public class ExampleUnitTest {
|
||||
|
||||
@Test
|
||||
public void addition_isCorrect() throws Exception {
|
||||
assertEquals(4, 2 + 2);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,12 @@
|
||||
#!/bin/sh
|
||||
# Build the WikiDeck debug APK against the private Night-1 testnet.
|
||||
# Needs ANDROID_HOME and a JDK 21 (JAVA_HOME). Output: android/app/build/outputs/apk/debug/app-debug.apk
|
||||
set -eu
|
||||
cd "$(dirname "$0")/.."
|
||||
export VITE_WIKIDECK_NETWORK="${VITE_WIKIDECK_NETWORK:-testnet}"
|
||||
export VITE_WIKIDECK_GENESIS_TIME="${VITE_WIKIDECK_GENESIS_TIME:-1792411200}"
|
||||
export VITE_NODE_URL="${VITE_NODE_URL:-http://192.168.1.32:3101}"
|
||||
npm run build
|
||||
npx cap sync android
|
||||
cd android && ./gradlew --no-daemon -q assembleDebug
|
||||
ls -l app/build/outputs/apk/debug/app-debug.apk
|
||||
@@ -0,0 +1,29 @@
|
||||
// Top-level build file where you can add configuration options common to all sub-projects/modules.
|
||||
|
||||
buildscript {
|
||||
|
||||
repositories {
|
||||
google()
|
||||
mavenCentral()
|
||||
}
|
||||
dependencies {
|
||||
classpath 'com.android.tools.build:gradle:8.7.2'
|
||||
classpath 'com.google.gms:google-services:4.4.2'
|
||||
|
||||
// NOTE: Do not place your application dependencies here; they belong
|
||||
// in the individual module build.gradle files
|
||||
}
|
||||
}
|
||||
|
||||
apply from: "variables.gradle"
|
||||
|
||||
allprojects {
|
||||
repositories {
|
||||
google()
|
||||
mavenCentral()
|
||||
}
|
||||
}
|
||||
|
||||
task clean(type: Delete) {
|
||||
delete rootProject.buildDir
|
||||
}
|
||||
@@ -0,0 +1,9 @@
|
||||
// DO NOT EDIT THIS FILE! IT IS GENERATED EACH TIME "capacitor update" IS RUN
|
||||
include ':capacitor-android'
|
||||
project(':capacitor-android').projectDir = new File('../node_modules/@capacitor/android/capacitor')
|
||||
|
||||
include ':capacitor-app'
|
||||
project(':capacitor-app').projectDir = new File('../node_modules/@capacitor/app/android')
|
||||
|
||||
include ':capacitor-browser'
|
||||
project(':capacitor-browser').projectDir = new File('../node_modules/@capacitor/browser/android')
|
||||
@@ -0,0 +1,22 @@
|
||||
# Project-wide Gradle settings.
|
||||
|
||||
# IDE (e.g. Android Studio) users:
|
||||
# Gradle settings configured through the IDE *will override*
|
||||
# any settings specified in this file.
|
||||
|
||||
# For more details on how to configure your build environment visit
|
||||
# http://www.gradle.org/docs/current/userguide/build_environment.html
|
||||
|
||||
# Specifies the JVM arguments used for the daemon process.
|
||||
# The setting is particularly useful for tweaking memory settings.
|
||||
org.gradle.jvmargs=-Xmx1536m
|
||||
|
||||
# When configured, Gradle will run in incubating parallel mode.
|
||||
# This option should only be used with decoupled projects. More details, visit
|
||||
# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
|
||||
# org.gradle.parallel=true
|
||||
|
||||
# AndroidX package structure to make it clearer which packages are bundled with the
|
||||
# Android operating system, and which are packaged with your app's APK
|
||||
# https://developer.android.com/topic/libraries/support-library/androidx-rn
|
||||
android.useAndroidX=true
|
||||
@@ -0,0 +1,7 @@
|
||||
distributionBase=GRADLE_USER_HOME
|
||||
distributionPath=wrapper/dists
|
||||
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-all.zip
|
||||
networkTimeout=10000
|
||||
validateDistributionUrl=true
|
||||
zipStoreBase=GRADLE_USER_HOME
|
||||
zipStorePath=wrapper/dists
|
||||
@@ -0,0 +1,252 @@
|
||||
#!/bin/sh
|
||||
|
||||
#
|
||||
# Copyright © 2015-2021 the original authors.
|
||||
#
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
# You may obtain a copy of the License at
|
||||
#
|
||||
# https://www.apache.org/licenses/LICENSE-2.0
|
||||
#
|
||||
# Unless required by applicable law or agreed to in writing, software
|
||||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
# See the License for the specific language governing permissions and
|
||||
# limitations under the License.
|
||||
#
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
#
|
||||
|
||||
##############################################################################
|
||||
#
|
||||
# Gradle start up script for POSIX generated by Gradle.
|
||||
#
|
||||
# Important for running:
|
||||
#
|
||||
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
|
||||
# noncompliant, but you have some other compliant shell such as ksh or
|
||||
# bash, then to run this script, type that shell name before the whole
|
||||
# command line, like:
|
||||
#
|
||||
# ksh Gradle
|
||||
#
|
||||
# Busybox and similar reduced shells will NOT work, because this script
|
||||
# requires all of these POSIX shell features:
|
||||
# * functions;
|
||||
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
|
||||
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
|
||||
# * compound commands having a testable exit status, especially «case»;
|
||||
# * various built-in commands including «command», «set», and «ulimit».
|
||||
#
|
||||
# Important for patching:
|
||||
#
|
||||
# (2) This script targets any POSIX shell, so it avoids extensions provided
|
||||
# by Bash, Ksh, etc; in particular arrays are avoided.
|
||||
#
|
||||
# The "traditional" practice of packing multiple parameters into a
|
||||
# space-separated string is a well documented source of bugs and security
|
||||
# problems, so this is (mostly) avoided, by progressively accumulating
|
||||
# options in "$@", and eventually passing that to Java.
|
||||
#
|
||||
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
|
||||
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
|
||||
# see the in-line comments for details.
|
||||
#
|
||||
# There are tweaks for specific operating systems such as AIX, CygWin,
|
||||
# Darwin, MinGW, and NonStop.
|
||||
#
|
||||
# (3) This script is generated from the Groovy template
|
||||
# https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
|
||||
# within the Gradle project.
|
||||
#
|
||||
# You can find Gradle at https://github.com/gradle/gradle/.
|
||||
#
|
||||
##############################################################################
|
||||
|
||||
# Attempt to set APP_HOME
|
||||
|
||||
# Resolve links: $0 may be a link
|
||||
app_path=$0
|
||||
|
||||
# Need this for daisy-chained symlinks.
|
||||
while
|
||||
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
|
||||
[ -h "$app_path" ]
|
||||
do
|
||||
ls=$( ls -ld "$app_path" )
|
||||
link=${ls#*' -> '}
|
||||
case $link in #(
|
||||
/*) app_path=$link ;; #(
|
||||
*) app_path=$APP_HOME$link ;;
|
||||
esac
|
||||
done
|
||||
|
||||
# This is normally unused
|
||||
# shellcheck disable=SC2034
|
||||
APP_BASE_NAME=${0##*/}
|
||||
# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
|
||||
APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s
|
||||
' "$PWD" ) || exit
|
||||
|
||||
# Use the maximum available, or set MAX_FD != -1 to use that value.
|
||||
MAX_FD=maximum
|
||||
|
||||
warn () {
|
||||
echo "$*"
|
||||
} >&2
|
||||
|
||||
die () {
|
||||
echo
|
||||
echo "$*"
|
||||
echo
|
||||
exit 1
|
||||
} >&2
|
||||
|
||||
# OS specific support (must be 'true' or 'false').
|
||||
cygwin=false
|
||||
msys=false
|
||||
darwin=false
|
||||
nonstop=false
|
||||
case "$( uname )" in #(
|
||||
CYGWIN* ) cygwin=true ;; #(
|
||||
Darwin* ) darwin=true ;; #(
|
||||
MSYS* | MINGW* ) msys=true ;; #(
|
||||
NONSTOP* ) nonstop=true ;;
|
||||
esac
|
||||
|
||||
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
|
||||
|
||||
|
||||
# Determine the Java command to use to start the JVM.
|
||||
if [ -n "$JAVA_HOME" ] ; then
|
||||
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
|
||||
# IBM's JDK on AIX uses strange locations for the executables
|
||||
JAVACMD=$JAVA_HOME/jre/sh/java
|
||||
else
|
||||
JAVACMD=$JAVA_HOME/bin/java
|
||||
fi
|
||||
if [ ! -x "$JAVACMD" ] ; then
|
||||
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
|
||||
|
||||
Please set the JAVA_HOME variable in your environment to match the
|
||||
location of your Java installation."
|
||||
fi
|
||||
else
|
||||
JAVACMD=java
|
||||
if ! command -v java >/dev/null 2>&1
|
||||
then
|
||||
die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
|
||||
|
||||
Please set the JAVA_HOME variable in your environment to match the
|
||||
location of your Java installation."
|
||||
fi
|
||||
fi
|
||||
|
||||
# Increase the maximum file descriptors if we can.
|
||||
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
|
||||
case $MAX_FD in #(
|
||||
max*)
|
||||
# In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
|
||||
# shellcheck disable=SC2039,SC3045
|
||||
MAX_FD=$( ulimit -H -n ) ||
|
||||
warn "Could not query maximum file descriptor limit"
|
||||
esac
|
||||
case $MAX_FD in #(
|
||||
'' | soft) :;; #(
|
||||
*)
|
||||
# In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
|
||||
# shellcheck disable=SC2039,SC3045
|
||||
ulimit -n "$MAX_FD" ||
|
||||
warn "Could not set maximum file descriptor limit to $MAX_FD"
|
||||
esac
|
||||
fi
|
||||
|
||||
# Collect all arguments for the java command, stacking in reverse order:
|
||||
# * args from the command line
|
||||
# * the main class name
|
||||
# * -classpath
|
||||
# * -D...appname settings
|
||||
# * --module-path (only if needed)
|
||||
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
|
||||
|
||||
# For Cygwin or MSYS, switch paths to Windows format before running java
|
||||
if "$cygwin" || "$msys" ; then
|
||||
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
|
||||
CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
|
||||
|
||||
JAVACMD=$( cygpath --unix "$JAVACMD" )
|
||||
|
||||
# Now convert the arguments - kludge to limit ourselves to /bin/sh
|
||||
for arg do
|
||||
if
|
||||
case $arg in #(
|
||||
-*) false ;; # don't mess with options #(
|
||||
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
|
||||
[ -e "$t" ] ;; #(
|
||||
*) false ;;
|
||||
esac
|
||||
then
|
||||
arg=$( cygpath --path --ignore --mixed "$arg" )
|
||||
fi
|
||||
# Roll the args list around exactly as many times as the number of
|
||||
# args, so each arg winds up back in the position where it started, but
|
||||
# possibly modified.
|
||||
#
|
||||
# NB: a `for` loop captures its iteration list before it begins, so
|
||||
# changing the positional parameters here affects neither the number of
|
||||
# iterations, nor the values presented in `arg`.
|
||||
shift # remove old arg
|
||||
set -- "$@" "$arg" # push replacement arg
|
||||
done
|
||||
fi
|
||||
|
||||
|
||||
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
|
||||
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
|
||||
|
||||
# Collect all arguments for the java command:
|
||||
# * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
|
||||
# and any embedded shellness will be escaped.
|
||||
# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
|
||||
# treated as '${Hostname}' itself on the command line.
|
||||
|
||||
set -- \
|
||||
"-Dorg.gradle.appname=$APP_BASE_NAME" \
|
||||
-classpath "$CLASSPATH" \
|
||||
org.gradle.wrapper.GradleWrapperMain \
|
||||
"$@"
|
||||
|
||||
# Stop when "xargs" is not available.
|
||||
if ! command -v xargs >/dev/null 2>&1
|
||||
then
|
||||
die "xargs is not available"
|
||||
fi
|
||||
|
||||
# Use "xargs" to parse quoted args.
|
||||
#
|
||||
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
|
||||
#
|
||||
# In Bash we could simply go:
|
||||
#
|
||||
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
|
||||
# set -- "${ARGS[@]}" "$@"
|
||||
#
|
||||
# but POSIX shell has neither arrays nor command substitution, so instead we
|
||||
# post-process each arg (as a line of input to sed) to backslash-escape any
|
||||
# character that might be a shell metacharacter, then use eval to reverse
|
||||
# that process (while maintaining the separation between arguments), and wrap
|
||||
# the whole thing up as a single "set" statement.
|
||||
#
|
||||
# This will of course break if any of these variables contains a newline or
|
||||
# an unmatched quote.
|
||||
#
|
||||
|
||||
eval "set -- $(
|
||||
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
|
||||
xargs -n1 |
|
||||
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
|
||||
tr '\n' ' '
|
||||
)" '"$@"'
|
||||
|
||||
exec "$JAVACMD" "$@"
|
||||
@@ -0,0 +1,94 @@
|
||||
@rem
|
||||
@rem Copyright 2015 the original author or authors.
|
||||
@rem
|
||||
@rem Licensed under the Apache License, Version 2.0 (the "License");
|
||||
@rem you may not use this file except in compliance with the License.
|
||||
@rem You may obtain a copy of the License at
|
||||
@rem
|
||||
@rem https://www.apache.org/licenses/LICENSE-2.0
|
||||
@rem
|
||||
@rem Unless required by applicable law or agreed to in writing, software
|
||||
@rem distributed under the License is distributed on an "AS IS" BASIS,
|
||||
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
@rem See the License for the specific language governing permissions and
|
||||
@rem limitations under the License.
|
||||
@rem
|
||||
@rem SPDX-License-Identifier: Apache-2.0
|
||||
@rem
|
||||
|
||||
@if "%DEBUG%"=="" @echo off
|
||||
@rem ##########################################################################
|
||||
@rem
|
||||
@rem Gradle startup script for Windows
|
||||
@rem
|
||||
@rem ##########################################################################
|
||||
|
||||
@rem Set local scope for the variables with windows NT shell
|
||||
if "%OS%"=="Windows_NT" setlocal
|
||||
|
||||
set DIRNAME=%~dp0
|
||||
if "%DIRNAME%"=="" set DIRNAME=.
|
||||
@rem This is normally unused
|
||||
set APP_BASE_NAME=%~n0
|
||||
set APP_HOME=%DIRNAME%
|
||||
|
||||
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
|
||||
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
|
||||
|
||||
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
|
||||
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
|
||||
|
||||
@rem Find java.exe
|
||||
if defined JAVA_HOME goto findJavaFromJavaHome
|
||||
|
||||
set JAVA_EXE=java.exe
|
||||
%JAVA_EXE% -version >NUL 2>&1
|
||||
if %ERRORLEVEL% equ 0 goto execute
|
||||
|
||||
echo. 1>&2
|
||||
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
|
||||
echo. 1>&2
|
||||
echo Please set the JAVA_HOME variable in your environment to match the 1>&2
|
||||
echo location of your Java installation. 1>&2
|
||||
|
||||
goto fail
|
||||
|
||||
:findJavaFromJavaHome
|
||||
set JAVA_HOME=%JAVA_HOME:"=%
|
||||
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
|
||||
|
||||
if exist "%JAVA_EXE%" goto execute
|
||||
|
||||
echo. 1>&2
|
||||
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
|
||||
echo. 1>&2
|
||||
echo Please set the JAVA_HOME variable in your environment to match the 1>&2
|
||||
echo location of your Java installation. 1>&2
|
||||
|
||||
goto fail
|
||||
|
||||
:execute
|
||||
@rem Setup the command line
|
||||
|
||||
set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
|
||||
|
||||
|
||||
@rem Execute Gradle
|
||||
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
|
||||
|
||||
:end
|
||||
@rem End local scope for the variables with windows NT shell
|
||||
if %ERRORLEVEL% equ 0 goto mainEnd
|
||||
|
||||
:fail
|
||||
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
|
||||
rem the _cmd.exe /c_ return code!
|
||||
set EXIT_CODE=%ERRORLEVEL%
|
||||
if %EXIT_CODE% equ 0 set EXIT_CODE=1
|
||||
if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
|
||||
exit /b %EXIT_CODE%
|
||||
|
||||
:mainEnd
|
||||
if "%OS%"=="Windows_NT" endlocal
|
||||
|
||||
:omega
|
||||
@@ -0,0 +1,5 @@
|
||||
include ':app'
|
||||
include ':capacitor-cordova-android-plugins'
|
||||
project(':capacitor-cordova-android-plugins').projectDir = new File('./capacitor-cordova-android-plugins/')
|
||||
|
||||
apply from: 'capacitor.settings.gradle'
|
||||
@@ -0,0 +1,16 @@
|
||||
ext {
|
||||
minSdkVersion = 23
|
||||
compileSdkVersion = 35
|
||||
targetSdkVersion = 35
|
||||
androidxActivityVersion = '1.9.2'
|
||||
androidxAppCompatVersion = '1.7.0'
|
||||
androidxCoordinatorLayoutVersion = '1.2.0'
|
||||
androidxCoreVersion = '1.15.0'
|
||||
androidxFragmentVersion = '1.8.4'
|
||||
coreSplashScreenVersion = '1.0.1'
|
||||
androidxWebkitVersion = '1.12.1'
|
||||
junitVersion = '4.13.2'
|
||||
androidxJunitVersion = '1.2.1'
|
||||
androidxEspressoCoreVersion = '3.6.1'
|
||||
cordovaAndroidVersion = '10.1.1'
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
import type { CapacitorConfig } from '@capacitor/cli';
|
||||
|
||||
// WikiDeck mobile shell. Build the web UI with the node URL baked in, then sync:
|
||||
// VITE_WIKIDECK_NETWORK=testnet VITE_WIKIDECK_GENESIS_TIME=1792411200 \
|
||||
// VITE_NODE_URL=http://192.168.1.32:3101 npm run build && npx cap sync android
|
||||
// (see android/build-debug.sh)
|
||||
const config: CapacitorConfig = {
|
||||
appId: 'dev.eom.wikideck',
|
||||
appName: 'WikiDeck',
|
||||
webDir: 'dist',
|
||||
server: {
|
||||
androidScheme: 'https',
|
||||
// The private testnet node is plain HTTP on the LAN.
|
||||
cleartext: true,
|
||||
},
|
||||
android: {
|
||||
// Android 15 (targetSdk 35) draws edge-to-edge; keep the WebView clear of the system bars.
|
||||
adjustMarginsForEdgeToEdge: 'auto',
|
||||
},
|
||||
plugins: {
|
||||
// Route fetch through native HTTP: avoids CORS and the node's browser Origin check.
|
||||
CapacitorHttp: { enabled: true },
|
||||
},
|
||||
};
|
||||
|
||||
export default config;
|
||||
@@ -0,0 +1,22 @@
|
||||
# Night 1 private testnet (sim-testnet)
|
||||
|
||||
A 3-node **testnet-only** fixture on poweredge-r350. It is reachable on the LAN only, and uses the Docker project `wikideck-night`.
|
||||
|
||||
| node | URL |
|
||||
|---|---|
|
||||
| node-a | http://192.168.1.32:3101 |
|
||||
| node-b | http://192.168.1.32:3102 |
|
||||
| node-c | http://192.168.1.32:3103 |
|
||||
|
||||
- `compose.lan.yaml` overrides only the published ports (bound to `192.168.1.32`, never `0.0.0.0`) and `PUBLIC_ORIGIN`. It changes nothing in consensus or the image.
|
||||
- `mine.ts` is a multi-worker native RandomX miner. It runs inside the `wikideck:testnet` image, which ships the native engine, so the host needs no cmake.
|
||||
- It mines to 4 disposable wallets (alice, bob, carol, dave) and writes chain-bound encrypted browser backups to `$STATE_DIR/wallets/`.
|
||||
- It never changes consensus code. Speed comes from the protocol's own testnet parameters: the initial target accepts 1/16 of hashes, and each 10-block retarget at most quadruples the difficulty.
|
||||
- Each template costs several Wikipedia API calls, and Wikipedia rate-limits our egress IP. The miner therefore paces templates (`MIN_GAP`, default 45 s) and backs off exponentially on failure.
|
||||
- `compose.lan.yaml` also sets, per node:
|
||||
- `WIKIDECK_USER_AGENT`, a Wikimedia-policy UA with a project URL (#19). Without it, Wikipedia returned 429 to our egress and templates failed.
|
||||
- the game-mode env from #22: A = classic and trending, B = draft, C = all three.
|
||||
- `autodeploy.sh` follows the integration branch. Run it from a dedicated detached worktree: `git worktree add --detach ../deploy-src origin/night/2026-11-16 && cd ../deploy-src && deploy/night/autodeploy.sh`. It polls the Gitea API every 3 min and redeploys whenever the head moves.
|
||||
- `testnet.sh` has `up`, `mine N [workers]`, `status` and `down`. Run it from the repo root on a checkout of the integration branch. `up` rebuilds the image from that checkout; the ledgers persist in the named volumes.
|
||||
|
||||
Never point this at mainnet or the live `wikideck` namespace.
|
||||
@@ -0,0 +1,40 @@
|
||||
#!/bin/sh
|
||||
# sim-testnet: keep the wikideck-night testnet on the integration branch head.
|
||||
# Run from the root of a *dedicated* checkout (e.g. a detached git worktree): it checks out
|
||||
# each new head of $BRANCH and runs `deploy/night/testnet.sh rolling` (ledgers persist in the volumes):
|
||||
# nodes restart one at a time, and deploys wait (up to FORCE_AFTER) while matches or lobbies are live,
|
||||
# because lobbies are in memory and a restart ends games in progress.
|
||||
# Head detection uses the public Gitea API, which also works where SSH auth isn't available.
|
||||
set -u
|
||||
BRANCH=${BRANCH:-night/2026-11-16}
|
||||
API=${API:-https://gitea.eom.dev/api/v1/repos/claude/wikideck}
|
||||
INTERVAL=${INTERVAL:-180}
|
||||
LOG=${LOG:-/tmp/wikideck-night-autodeploy.log}
|
||||
FORCE_AFTER=${FORCE_AFTER:-900} # defer while matches/lobbies are live, but at most this many seconds
|
||||
deferred_since=
|
||||
enc=$(printf %s "$BRANCH" | sed 's#/#%2F#g')
|
||||
while :; do
|
||||
new=$(node -e "fetch('$API/branches/$enc',{signal:AbortSignal.timeout(15000)}).then(r=>r.json()).then(b=>console.log(b.commit.id)).catch(()=>{})")
|
||||
cur=$(git rev-parse HEAD)
|
||||
if [ -z "$new" ]; then echo "WARN branch API failed"
|
||||
elif [ "$new" != "$cur" ]; then
|
||||
if ! git fetch -q origin "+refs/heads/$BRANCH:refs/remotes/origin/$BRANCH" 2>"$LOG"; then
|
||||
echo "WARN fetch failed: $(tail -1 "$LOG")"
|
||||
else
|
||||
busy=$(deploy/night/testnet.sh busy 2>/dev/null || echo 0)
|
||||
now=$(date +%s)
|
||||
if [ "${busy:-0}" -gt 0 ] && { [ -z "$deferred_since" ] || [ $((now - deferred_since)) -lt "$FORCE_AFTER" ]; }; then
|
||||
[ -z "$deferred_since" ] && { deferred_since=$now; echo "DEFER ${new%"${new#???????}"}: $busy live matches/lobbies"; }
|
||||
sleep 60; continue
|
||||
fi
|
||||
[ -n "$deferred_since" ] && [ "${busy:-0}" -gt 0 ] && echo "FORCE deploy after ${FORCE_AFTER}s ($busy still live)"
|
||||
deferred_since=
|
||||
git checkout -q --detach "$new"
|
||||
echo "DEPLOY start $(git log --oneline -1 | cut -c1-90)"
|
||||
if deploy/night/testnet.sh rolling >"$LOG" 2>&1; then
|
||||
sleep 20; echo "DEPLOY ok $(git rev-parse --short HEAD): $(deploy/night/testnet.sh status 2>&1 | tr '\n' ' ')"
|
||||
else echo "DEPLOY FAILED $(git rev-parse --short HEAD): $(tail -3 "$LOG" | tr '\n' ' ')"; fi
|
||||
fi
|
||||
fi
|
||||
sleep "$INTERVAL"
|
||||
done
|
||||
@@ -0,0 +1,28 @@
|
||||
# sim-testnet override: publish the fixture on r350's LAN address only (not 0.0.0.0).
|
||||
# WIKIDECK_USER_AGENT identifies the testnet to Wikimedia (UA policy; no personal contact info).
|
||||
# Game-mode env (modes team, #6) is inert until night/modes/hosting merges.
|
||||
services:
|
||||
node-a:
|
||||
ports: !override ["192.168.1.32:3101:3001"]
|
||||
environment:
|
||||
PUBLIC_ORIGIN: http://192.168.1.32:3101
|
||||
WIKIDECK_USER_AGENT: &ua WikiDeck-testnet/0.1 (https://gitea.eom.dev/claude/wikideck; private testnet)
|
||||
WIKIDECK_MODES: classic,trending
|
||||
WIKIDECK_GAME_OPERATOR: Testnet A
|
||||
WIKIDECK_GAME_PEERS: http://192.168.1.32:3102,http://192.168.1.32:3103
|
||||
node-b:
|
||||
ports: !override ["192.168.1.32:3102:3001"]
|
||||
environment:
|
||||
PUBLIC_ORIGIN: http://192.168.1.32:3102
|
||||
WIKIDECK_USER_AGENT: *ua
|
||||
WIKIDECK_MODES: draft
|
||||
WIKIDECK_GAME_OPERATOR: Testnet B
|
||||
WIKIDECK_GAME_PEERS: http://192.168.1.32:3101,http://192.168.1.32:3103
|
||||
node-c:
|
||||
ports: !override ["192.168.1.32:3103:3001"]
|
||||
environment:
|
||||
PUBLIC_ORIGIN: http://192.168.1.32:3103
|
||||
WIKIDECK_USER_AGENT: *ua
|
||||
WIKIDECK_MODES: classic,trending,draft
|
||||
WIKIDECK_GAME_OPERATOR: Testnet C
|
||||
WIKIDECK_GAME_PEERS: http://192.168.1.32:3101,http://192.168.1.32:3102
|
||||
@@ -0,0 +1,100 @@
|
||||
// sim-testnet: multi-worker native RandomX miner for the PRIVATE wikideck-night testnet.
|
||||
// Runs inside the wikideck:testnet image (which ships the native engine). Testnet only.
|
||||
// Usage: node --experimental-strip-types /night/mine.ts <blocks> <workers>
|
||||
import { mkdirSync, readFileSync, writeFileSync, existsSync, appendFileSync } from 'node:fs';
|
||||
import { randomInt, webcrypto } from 'node:crypto';
|
||||
import { RandomX } from '/app/server/testnet/randomx.ts';
|
||||
import { CHAIN_ID, sha256, miningBlob, mintId, blockSchema, address } from '/app/server/testnet/consensus.ts';
|
||||
import { blockClaimMessage, NETWORK, type MiningTemplate, type TestnetBlock } from '/app/shared/testnet.ts';
|
||||
import { encryptWallet } from '/app/shared/wallet-backup.ts';
|
||||
|
||||
if (!NETWORK.includes('testnet')) throw new Error('testnet only');
|
||||
const blocks = Number(process.argv[2] ?? 45), workers = Number(process.argv[3] ?? 4);
|
||||
if (!(workers >= 1 && workers <= 8)) throw new Error('1..8 workers');
|
||||
const NODES = ['http://node-a:3001', 'http://node-b:3001', 'http://node-c:3001'];
|
||||
const WALLET_NAMES = ['alice', 'bob', 'carol', 'dave'];
|
||||
// PUBLIC, TESTNET-ONLY password for the disposable wallets' browser backups (posted on #4). Never reuse.
|
||||
const PASSWORD = process.env.TESTNET_WALLET_PASSWORD ?? 'wikideck-night-testnet';
|
||||
const STATE = process.env.STATE_DIR ?? '/state';
|
||||
const dir = `${STATE}/wallets`;
|
||||
mkdirSync(dir, { recursive: true });
|
||||
const subtle = webcrypto.subtle;
|
||||
|
||||
type W = { name: string; address: string; publicKey: string; privateKey: CryptoKey };
|
||||
async function loadOrCreate(name: string): Promise<W> {
|
||||
const keyFile = `${dir}/${name}.jwk.json`;
|
||||
let jwk: JsonWebKey;
|
||||
if (existsSync(keyFile)) jwk = JSON.parse(readFileSync(keyFile, 'utf8'));
|
||||
else {
|
||||
const kp = await subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, true, ['sign', 'verify']) as CryptoKeyPair;
|
||||
jwk = await subtle.exportKey('jwk', kp.privateKey);
|
||||
writeFileSync(keyFile, JSON.stringify(jwk), { mode: 0o600 });
|
||||
}
|
||||
const privateKey = await subtle.importKey('jwk', jwk, { name: 'ECDSA', namedCurve: 'P-256' }, true, ['sign']);
|
||||
const pubJwk = { kty: jwk.kty, crv: jwk.crv, x: jwk.x, y: jwk.y };
|
||||
const pub = await subtle.importKey('jwk', pubJwk, { name: 'ECDSA', namedCurve: 'P-256' }, true, ['verify']);
|
||||
const publicKey = Buffer.from(await subtle.exportKey('spki', pub)).toString('base64');
|
||||
const w = { name, address: address(publicKey), publicKey, privateKey };
|
||||
const backupFile = `${dir}/${name}.backup.json`;
|
||||
if (!existsSync(backupFile)) writeFileSync(backupFile, JSON.stringify(await encryptWallet(privateKey, publicKey, PASSWORD), null, 2));
|
||||
return w;
|
||||
}
|
||||
const wallets = await Promise.all(WALLET_NAMES.map(loadOrCreate));
|
||||
writeFileSync(`${dir}/addresses.json`, JSON.stringify(Object.fromEntries(wallets.map(w => [w.name, w.address])), null, 2));
|
||||
console.log(`chain ${CHAIN_ID}; wallets: ${wallets.map(w => `${w.name}=${w.address.slice(0, 12)}`).join(' ')}`);
|
||||
|
||||
async function api(node: string, path: string, body?: unknown) {
|
||||
const r = await fetch(node + path, { method: body ? 'POST' : 'GET', redirect: 'error', signal: AbortSignal.timeout(60000),
|
||||
headers: body ? { 'Content-Type': 'application/json' } : {}, body: body ? JSON.stringify(body) : undefined });
|
||||
const data = await r.json();
|
||||
if (!r.ok) throw new Error(data.error ?? `HTTP ${r.status}`);
|
||||
return data;
|
||||
}
|
||||
const engines = Array.from({ length: workers }, () => new RandomX());
|
||||
const close = () => { for (const e of engines) e.close(); };
|
||||
process.once('SIGTERM', () => { close(); process.exit(0); });
|
||||
|
||||
let accepted = 0, round = 0, fails = 0;
|
||||
// Each template costs several Wikipedia API calls, and Wikipedia rate-limits this egress IP:
|
||||
// pace templates (>= MIN_GAP s apart) and back off exponentially on failure.
|
||||
const MIN_GAP = Number(process.env.MIN_GAP ?? 45), sleep = (s: number) => new Promise(r => setTimeout(r, s * 1000));
|
||||
let lastTemplate = 0;
|
||||
try {
|
||||
while (accepted < blocks) {
|
||||
const wait = lastTemplate + MIN_GAP * 1000 - Date.now(); if (wait > 0) await sleep(wait / 1000);
|
||||
lastTemplate = Date.now();
|
||||
const node = NODES[round % NODES.length], w = wallets[accepted % wallets.length]; round++;
|
||||
let template: MiningTemplate;
|
||||
try { template = await api(node, '/api/mining/template', { owner: w.address, publicKey: w.publicKey }); fails = 0; }
|
||||
catch (e) { fails++; const b = Math.min(60 * 2 ** (fails - 1), 600); console.error(`template ${node}: ${(e as Error).message} (fail ${fails}, backoff ${b}s)`); await sleep(b); continue; }
|
||||
const h = template.header; if (h.chainId !== CHAIN_ID) throw new Error('wrong chain');
|
||||
const started = Date.now(); let attempts = 0; let found: { hash: string; nonce: number } | null = null;
|
||||
let base = randomInt(0, 2 ** 40); const BATCH = 64;
|
||||
while (!found) {
|
||||
const results = await Promise.all(engines.map((e, i) => {
|
||||
const hdr = { ...h, nonce: base + i * BATCH };
|
||||
return e.mine(h.key, miningBlob(hdr), h.target, 32, BATCH);
|
||||
}));
|
||||
attempts += BATCH * workers; base += BATCH * workers;
|
||||
found = results.find(Boolean) ?? null;
|
||||
if (!found && Date.now() / 1000 - h.createdAt > 600) break; // stale template
|
||||
}
|
||||
if (!found) continue;
|
||||
h.nonce = found.nonce;
|
||||
const hash = sha256(miningBlob(h));
|
||||
const signature = Buffer.from(await subtle.sign({ name: 'ECDSA', hash: 'SHA-256' }, w.privateKey,
|
||||
new TextEncoder().encode(blockClaimMessage(hash)))).toString('base64');
|
||||
const block: TestnetBlock = { ...h, hash, tokenId: mintId(h), powHash: found.hash, signature, transactions: template.transactions };
|
||||
blockSchema.parse(block);
|
||||
try {
|
||||
const res = await api(node, '/api/blocks', block);
|
||||
if (!res.accepted) { console.error(`not accepted: ${JSON.stringify(res).slice(0, 200)}`); continue; }
|
||||
accepted++;
|
||||
const secs = (Date.now() - started) / 1000;
|
||||
const line = `#${h.height} ${w.name} "${h.article.title}" token=${block.tokenId} via=${node} ${attempts}H ${(attempts / secs).toFixed(0)}H/s`;
|
||||
console.log(`[${accepted}/${blocks}] ${line}`);
|
||||
appendFileSync(`${STATE}/mined.log`, `${new Date().toISOString()} ${line}\n`);
|
||||
} catch (e) { console.error(`submit: ${(e as Error).message}`); }
|
||||
}
|
||||
} finally { close(); }
|
||||
console.log('done');
|
||||
@@ -0,0 +1,49 @@
|
||||
#!/bin/sh
|
||||
# sim-testnet: private 3-node testnet fixture for WikiDeck Night 1 (poweredge-r350, LAN only).
|
||||
# Usage (from the repo root):
|
||||
# deploy/night/testnet.sh up build the image from this checkout and (re)start the 3 nodes
|
||||
# deploy/night/testnet.sh rolling build, then restart node-a, b, c one at a time (waits for /healthz)
|
||||
# deploy/night/testnet.sh busy print live matches + open lobbies across the 3 nodes
|
||||
# deploy/night/testnet.sh mine N [W] mine N real RandomX blocks with W workers (default 4, max 8)
|
||||
# deploy/night/testnet.sh status tip/height of each node
|
||||
# deploy/night/testnet.sh down stop the nodes (volumes, i.e. the ledgers, are kept)
|
||||
# STATE_DIR (default ~/.local/share/wikideck-night) holds the disposable testnet wallets and mined.log.
|
||||
# It is outside the repo on purpose: never commit wallets.
|
||||
set -eu
|
||||
P=wikideck-night
|
||||
LAN_IP=${LAN_IP:-192.168.1.32}
|
||||
STATE_DIR=${STATE_DIR:-$HOME/.local/share/wikideck-night}
|
||||
DC="docker compose -p $P -f compose.testnet.yaml -f deploy/night/compose.lan.yaml"
|
||||
case "${1:-}" in
|
||||
up) $DC build node-a && $DC up -d --no-build ;;
|
||||
down) $DC down ;;
|
||||
rolling)
|
||||
# Never take the whole testnet dark: one node at a time, each must pass /healthz before the next.
|
||||
$DC build node-a
|
||||
for n in a b c; do
|
||||
port=$(( 3100 + $(printf %d "'$n") - 96 ))
|
||||
$DC up -d --no-build --no-deps node-$n
|
||||
i=0
|
||||
until node -e "fetch('http://$LAN_IP:$port/healthz',{signal:AbortSignal.timeout(3000)}).then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"; do
|
||||
i=$((i+1)); [ $i -ge 60 ] && { echo "node-$n not healthy after 120 s"; exit 1; }; sleep 2
|
||||
done
|
||||
echo "node-$n healthy"
|
||||
done ;;
|
||||
busy)
|
||||
# Sum of liveMatches + openLobbies over all hosted modes on all nodes (unreachable node counts 0).
|
||||
node -e "Promise.all([3101,3102,3103].map(p=>fetch('http://$LAN_IP:'+p+'/api/game/modes',{signal:AbortSignal.timeout(5000)}).then(r=>r.json()).then(m=>m.modes.reduce((t,x)=>t+(x.stats?.liveMatches??0)+(x.stats?.openLobbies??0),0)).catch(()=>0))).then(v=>console.log(v.reduce((a,b)=>a+b,0)))" ;;
|
||||
mine)
|
||||
mkdir -p "$STATE_DIR"
|
||||
W=${3:-4}
|
||||
docker rm -f $P-miner >/dev/null 2>&1 || true
|
||||
docker run -d --name $P-miner --network ${P}_default --cpus "$W" --memory 1600m \
|
||||
--user "$(id -u):$(id -g)" -e WIKIDECK_NETWORK=testnet -e WIKIDECK_GENESIS_TIME=1792411200 \
|
||||
-e MIN_GAP="${MIN_GAP:-45}" -v "$STATE_DIR":/state -v "$PWD/deploy/night":/night:ro \
|
||||
wikideck:testnet node --experimental-strip-types /night/mine.ts "$2" "$W"
|
||||
echo "follow with: docker logs -f $P-miner" ;;
|
||||
status)
|
||||
for port in 3101 3102 3103; do
|
||||
docker run --rm --network host wikideck:testnet node -e "fetch('http://$LAN_IP:$port/p2p/status').then(r=>r.json()).then(s=>console.log($port,'blocks',s.size,'tip',s.tip.slice(0,16))).catch(e=>console.log($port,'DOWN',e.message))"
|
||||
done ;;
|
||||
*) sed -n 2,11p "$0"; exit 1 ;;
|
||||
esac
|
||||
@@ -0,0 +1,462 @@
|
||||
# WikiDeck: Edit War — balance report
|
||||
|
||||
Owner: sim-balance (claude/wikideck#4). Harness: `shared/bots/`, `scripts/sim/` (PR #14).
|
||||
|
||||
## Report v1: 2026-11-17 00:45 EST
|
||||
|
||||
**Engine:** `night/2026-11-16` @ 482de6c/4a4941c (engine #25 and #27, keywords and Portals; card data #28).
|
||||
**Bots:** view-only (`viewFor`); see Method.
|
||||
**Card pool:** `docs/game/card-sample.json` (236 cards), derived per §1 with percentiles from the sample.
|
||||
**Decks:** the 4 §2.1 starter decks, 4 "realistic owned" decks (12 random cards from the sample), and archetypes.
|
||||
**Runs:**
|
||||
- full field: 3,000 matches per ruleset (report mix, 4 workers; r350 is memory-limited tonight)
|
||||
- focused starters + owned round robin: 2,000 matches per ruleset
|
||||
- greedy lever sweeps: 2,000–3,000 per variant
|
||||
|
||||
## v1.1 re-run on the real engine hooks (00:31)
|
||||
|
||||
**Engine:** `night/engine/v1-1` @ 4a0dbd0, with `RULESET_V1_1` (DESIGN #32): `viral {base 1, cap 3}`, `encyclopedic {sides 1}`, `rising.powerDelta -1`, `cultureKeyword: home`, `costThresholds [26,39,51,63,78]`. It is the same focused run as above: the §2.1 starters plus 4 owned decks (cost thresholds and Culture keyword per v1.1), 2,000 matches per ruleset.
|
||||
|
||||
| | v1 | **v1.1 (#32, exact)** | v1.1 + item 6 |
|
||||
|---|---|---|---|
|
||||
| starter deck WR, overall (FG / Head / Pio / Star) | 65 / 40 / 57 / 54 | **52 / 52 / 52 / 53** ✅ | 50 / 56 / 50 / 52 |
|
||||
| starter pairings, min–max | 23–77% | 39–61% (only FG–Head 61%, n = 51, is outside 45–55) | 42–58% |
|
||||
| owned vs starters (FG / Head / Pio / Star) | 37 / 54 / 40 / 41 | 51 / 42 / 47 / 43 | 51 / 41 / 46 / 48 |
|
||||
| first player | 53.4% | **51.2% [48.8–53.6]** ✅ | 51.0% [48.6–53.5] |
|
||||
| decided in the first third | 4.1% | 3.3% | 4.1% |
|
||||
| greedy > maxpower, lookahead-lite > greedy | 62%, 60% | 63%, 65% | 51%, 70% |
|
||||
|
||||
Net keyword value per card under the exact v1.1 (counterfactual trigger value plus `powerDelta`):
|
||||
|
||||
| keyword | v1.1 net per card |
|
||||
|---|---|
|
||||
| translated | **+1.64** |
|
||||
| nostalgic | **+1.69** |
|
||||
| viral | +1.15 (base included) |
|
||||
| encyclopedic | +0.77 |
|
||||
| rising | 1.71 − 1 = +0.71 |
|
||||
| local | +0.69 |
|
||||
|
||||
My earlier flat-+1 stand-in for encyclopedic overstated it: the real hook is worth +0.77, not +1.23.
|
||||
|
||||
**Updated recommendation:**
|
||||
1. **Ship #32 (v1.1) as it is.** Every starter's overall WR is 52–53% and first player is 51.2%. The one out-of-band pairing (FG vs Headliners at 61%) is within this run's noise.
|
||||
2. **Item 6 is an optional v1.2 candidate.** `nostalgic` and `translated` at `powerDelta -1` would bring translated and nostalgic (about +1.65) in line with the others (0.7–1.15). It fixes FG vs Headliners (50%), but at n ≈ 55 per pairing it isn't clearly better overall (42–58% vs 39–61%). Decide it on a larger run.
|
||||
3. **Owned vs starters is 42–51%:** roughly the variety-not-power goal, slightly weak against Headliners and Stargazers.
|
||||
|
||||
Raw tables:
|
||||
|
||||
#### `v1.1`: 2000 matches, 10 draws, 0 engine errors
|
||||
|
||||
- First player (turn-1 initiative), symmetric games: **51.2% [48.8–53.6] (n=1641)**
|
||||
- Decided early: 3.3% of decisive games locked in during the first third, 12.1% by half-time
|
||||
- Skill: greedy>maxpower 63.3% (n=147), lookahead-lite>greedy 64.6% (n=99), greedy>random 83.5% (n=103)
|
||||
|
||||
| starters (row vs col) | field-guide | headliners | pioneers | stargazers | vs all decks |
|
||||
|---|---|---|---|---|---|
|
||||
| field-guide | – | 61% (n=51) | 49% (n=53) | 56% (n=55) | 51.8% |
|
||||
| headliners | 39% (n=51) | – | 44% (n=54) | 50% (n=54) | 52.1% |
|
||||
| pioneers | 51% (n=53) | 56% (n=54) | – | 48% (n=58) | 52.3% |
|
||||
| stargazers | 44% (n=55) | 50% (n=54) | 52% (n=58) | – | 53.2% |
|
||||
|
||||
| owned (random 12 from card-sample) vs | field-guide | headliners | pioneers | stargazers | all |
|
||||
|---|---|---|---|---|---|
|
||||
| owned-0 | 39% | 32% | 41% | 46% | 40.3% |
|
||||
| owned-1 | 50% | 43% | 42% | 38% | 45.1% |
|
||||
| owned-2 | 55% | 37% | 62% | 44% | 49.7% |
|
||||
| owned-3 | 62% | 55% | 43% | 45% | 55.0% |
|
||||
| **all owned** | **51%** (n=233) | **42%** (n=196) | **47%** (n=198) | **43%** (n=198) | |
|
||||
|
||||
|
||||
| keyword | power per card | games decided by it | cards played |
|
||||
|---|---|---|---|
|
||||
| rising | +1.71 | 13.3% | 1503 |
|
||||
| nostalgic | +1.69 | 13.4% | 1791 |
|
||||
| translated | +1.64 | 17.8% | 4976 |
|
||||
| viral | +1.15 | 7.3% | 1852 |
|
||||
| encyclopedic | +0.77 | 6.2% | 2349 |
|
||||
| local | +0.69 | 6.4% | 4052 |
|
||||
|
||||
#### `v1.1+item6`: 2000 matches, 9 draws, 0 engine errors
|
||||
|
||||
- First player (turn-1 initiative), symmetric games: **51.0% [48.6–53.5] (n=1640)**
|
||||
- Decided early: 4.1% of decisive games locked in during the first third, 12.6% by half-time
|
||||
- Skill: greedy>maxpower 51.0% (n=147), lookahead-lite>greedy 70.0% (n=100), greedy>random 82.7% (n=104)
|
||||
|
||||
| starters (row vs col) | field-guide | headliners | pioneers | stargazers | vs all decks |
|
||||
|---|---|---|---|---|---|
|
||||
| field-guide | – | 50% (n=52) | 50% (n=52) | 53% (n=55) | 49.7% |
|
||||
| headliners | 50% (n=52) | – | 58% (n=55) | 48% (n=54) | 56.1% |
|
||||
| pioneers | 50% (n=52) | 42% (n=55) | – | 42% (n=57) | 49.7% |
|
||||
| stargazers | 47% (n=55) | 52% (n=54) | 58% (n=57) | – | 51.9% |
|
||||
|
||||
| owned (random 12 from card-sample) vs | field-guide | headliners | pioneers | stargazers | all |
|
||||
|---|---|---|---|---|---|
|
||||
| owned-0 | 48% | 41% | 50% | 39% | 47.1% |
|
||||
| owned-1 | 41% | 44% | 47% | 52% | 47.2% |
|
||||
| owned-2 | 57% | 36% | 38% | 51% | 48.8% |
|
||||
| owned-3 | 60% | 41% | 49% | 49% | 49.4% |
|
||||
| **all owned** | **51%** (n=233) | **41%** (n=197) | **46%** (n=200) | **48%** (n=198) | |
|
||||
|
||||
|
||||
| keyword | power per card | games decided by it | cards played |
|
||||
|---|---|---|---|
|
||||
| rising | +1.72 | 14.2% | 1546 |
|
||||
| translated | +1.69 | 17.0% | 4787 |
|
||||
| nostalgic | +1.68 | 13.2% | 1709 |
|
||||
| viral | +1.15 | 8.8% | 1924 |
|
||||
| encyclopedic | +0.79 | 6.7% | 2403 |
|
||||
| local | +0.70 | 6.7% | 4127 |
|
||||
|
||||
|
||||
### TL;DR for the council (report v1, 00:25; see the v1.1 re-run above for the updated recommendation)
|
||||
1. **Seat and initiative are fine:** 51.5% [49.6–53.5] for the turn-1 initiative holder (n = 2,421 symmetric games), and seat 0 51.2%. Draws are 0.4%. The tie-break (total power) decides 4.7% of games. *This full-field run started before the bot-side queue-count fix (PR #14); the effect is at most a 0.02 nudge to the heuristic. The focused starters run, after the fix, gives a borderline 53.4% [51.0–55.8] under v1 and **51.0% [48.6–53.4]** under the recommended v1.1. Initiative only matters through reveal order, and v1.1 removes most of the order-sensitive power.*
|
||||
2. **Keyword values are lopsided, confirming the critic's figures within 0.2:**
|
||||
|
||||
| keyword | power per card |
|
||||
|---|---|
|
||||
| rising | +1.76 |
|
||||
| translated | +1.53 |
|
||||
| nostalgic | +1.45 |
|
||||
| local | +0.65 |
|
||||
| **viral** | **+0.19** |
|
||||
| **encyclopedic** | **+0.19** |
|
||||
|
||||
Values are counterfactual replays. viral and encyclopedic are dead: raising viral to amount 2 / cap 3 only reached +0.24, and encyclopedic amount 3 only +0.33. **Their conditions are the problem, not their numbers.**
|
||||
3. **The starter decks are not 45–55% in v1:** pairings run 23–77%. Field Guide (rising + nostalgic) wins 65% overall and Headliners (local + viral) 40%. **With v1.1 items 1–6, every pairing is 45–55%.**
|
||||
4. **Owned decks lose to the starters**, because they are about 51% viral and squashed into cost 2–4. That is the wrong way round for "NFTs give variety, not power".
|
||||
5. **`costThresholds` squash fame.** The owned cost mix is 3/23/37/22/10/5. `[26,39,51,63,78]` gives 13/20/22/20/15/10, which hits the target and confirms the critic and designer-a.
|
||||
6. **Pure extremes are dead under every lever:** heavy (cost 5–6 only) at 15%, swarm (cost ≤ 2) at 2%. Top-heavy (curve 1/1/2/2/3/3) is **57%**, so the §8 top-heavy retarget (≥ 40%) **passes**. Swarm and heavy aren't fixable without breaking curve decks: every lever that helps one hurts the other (sweep below). Treat them as non-decks.
|
||||
7. **Matches are always 6 turns.** Only 6.5% of decisive games are decided in the first third, and 19.9% by half-time, so most games stay live to the end.
|
||||
8. **Skill expression is healthy:**
|
||||
- greedy beats maxpower ("always play the biggest card") 59.5%. §8 wants the naive line under 55% against a smart bot; it is at 40.5%.
|
||||
- lookahead-lite beats greedy 63.7%.
|
||||
- greedy beats random 77.5%.
|
||||
|
||||
### Proposed v1.1 rule changes (concrete)
|
||||
|
||||
| # | Change | Evidence | Status |
|
||||
|---|---|---|---|
|
||||
| 1 | `costThresholds: [26, 39, 51, 63, 78]` (designer-a's quantile rule) | owned cost mix 3/23/37/22/10/5 → 13/20/22/20/15/10 | **adopt** |
|
||||
| 2 | `rising.powerDelta: -1` | rising +1.76 per card, the top keyword | **adopt** |
|
||||
| 3 | viral: "+1, plus +1 per earlier reveal this turn, max +3" (critic) | viral +0.19; buffing amount/cap alone gives +0.24 | **adopt.** It needs the base +1. |
|
||||
| 4 | encyclopedic: "+2 if *you* have no other cards here" (critic) | +0.19; amount 3 alone gives +0.33 | **adopt.** It needs the condition change. |
|
||||
| 5 | Culture takes its home-stat keyword (critic) | owned decks drop from 51% viral to 18% | see the v1.1 results |
|
||||
| 6 | `nostalgic.powerDelta -1`, `translated.powerDelta -1` | +1.45 / +1.53 per card, close to rising. Without them Field Guide beats Headliners 60% under 1–5 (approximated hooks). | **optional, v1.2**: see the v1.1 re-run above |
|
||||
| 7 | No change for heavy or swarm | no lever fixes both | – |
|
||||
| 8 | No change for seat or initiative | 48–52% target met | – |
|
||||
|
||||
### Starter round robin and owned vs starters (focused run: §2.1 starters plus 4 owned decks, 2,000 matches per ruleset)
|
||||
|
||||
| | v1 | v1.1 critic package (1–5) | **v1.1 critic + item 6** |
|
||||
|---|---|---|---|
|
||||
| starter pairings, min–max | **23–77%** | 40–60% | **45–55%** ✅ |
|
||||
| starter deck WR (FG / Head / Pio / Star) | 65 / 40 / 57 / 54 | 50 / 48 / 54 / 54 | 51 / 55 / 52 / 52 |
|
||||
| owned vs starters (FG / Head / Pio / Star) | 37 / 54 / 40 / 41 | 52 / 45 / 46 / 43 | 50 / 40 / 46 / 47 |
|
||||
| first player (turn-1 initiative) | 53.4% [51.0–55.8] | 52.5% [50.1–54.9] | **51.0% [48.6–53.4]** ✅ |
|
||||
| lookahead-lite > greedy | 60% | 70% | 66% |
|
||||
|
||||
Each starter pairing has about 50–58 symmetric games (±13 pp at 95%). Each owned-vs-starter cell has about 200 games (±7 pp).
|
||||
|
||||
**Net keyword value under v1.1** (counterfactual trigger value per card, plus `powerDelta`), from the 3,000-match critic-package full field:
|
||||
|
||||
| keyword | v1.1 net per card |
|
||||
|---|---|
|
||||
| rising | 1.74 − 1 = **+0.74** |
|
||||
| viral | 0.16 + 1 = **+1.16** |
|
||||
| encyclopedic | ≈ 0.23 + 1 = **+1.23** (approximated) |
|
||||
| translated | +1.59, or **+0.59** with item 6 |
|
||||
| nostalgic | +1.58, or **+0.58** with item 6 |
|
||||
| local | **+0.66** |
|
||||
|
||||
So every keyword lands within 0.6–1.2. This matches the critic's numbers (viral +1.15, encyclopedic +0.9, rising +0.9) to within 0.35.
|
||||
|
||||
**Recommendation: ship items 1–5 plus item 6** (`nostalgic.powerDelta -1`, `translated.powerDelta -1`). Without item 6, Field Guide still beats Headliners 60% and Headliners sits at 40–41% against every starter. With it, every pairing is inside 45–55. Owned decks then win 40–50% against the starters: the variety-not-power goal, slightly on the weak side. If v1.2 wants owned decks a bit stronger, the next lever is `local.amount 2` (Headliners and owned decks are about 25% local).
|
||||
|
||||
Raw tables:
|
||||
|
||||
#### `v1` (DEFAULT_RULESET), focused: 2000 matches, 9 draws, 0 engine errors
|
||||
|
||||
- First player (turn-1 initiative), symmetric games: **53.4% [51.0–55.8] (n=1641)**
|
||||
- Decided early: 4.1% of decisive games locked in during the first third, 15.5% by half-time
|
||||
- Skill: greedy>maxpower 61.6% (n=146), lookahead-lite>greedy 60.0% (n=100), greedy>random 81.7% (n=104)
|
||||
|
||||
| starters (row vs col) | field-guide | headliners | pioneers | stargazers | vs all decks |
|
||||
|---|---|---|---|---|---|
|
||||
| field-guide | – | 77% (n=52) | 57% (n=53) | 69% (n=54) | 64.8% |
|
||||
| headliners | 23% (n=52) | – | 36% (n=56) | 35% (n=54) | 39.6% |
|
||||
| pioneers | 43% (n=53) | 64% (n=56) | – | 52% (n=58) | 56.9% |
|
||||
| stargazers | 31% (n=54) | 65% (n=54) | 48% (n=58) | – | 54.3% |
|
||||
|
||||
| owned (random 12 from card-sample) vs | field-guide | headliners | pioneers | stargazers | all |
|
||||
|---|---|---|---|---|---|
|
||||
| owned-0 | 42% | 48% | 35% | 37% | 40.0% |
|
||||
| owned-1 | 26% | 62% | 40% | 45% | 47.4% |
|
||||
| owned-2 | 45% | 57% | 44% | 43% | 52.7% |
|
||||
| owned-3 | 35% | 47% | 40% | 37% | 42.3% |
|
||||
| **all owned** | **37%** (n=233) | **54%** (n=197) | **40%** (n=200) | **41%** (n=197) | |
|
||||
|
||||
|
||||
| keyword | power per card | games decided by it | cards played |
|
||||
|---|---|---|---|
|
||||
| rising | +1.75 | 12.0% | 1822 |
|
||||
| translated | +1.55 | 18.6% | 2263 |
|
||||
| nostalgic | +1.54 | 10.3% | 2197 |
|
||||
| local | +0.71 | 6.2% | 4300 |
|
||||
| viral | +0.22 | 3.3% | 6034 |
|
||||
| encyclopedic | +0.17 | 0.8% | 1042 |
|
||||
|
||||
#### `v1.1-critic`: 2000 matches, 4 draws, 0 engine errors
|
||||
|
||||
- First player (turn-1 initiative), symmetric games: **52.5% [50.1–54.9] (n=1646)**
|
||||
- Decided early: 3.5% of decisive games locked in during the first third, 11.4% by half-time
|
||||
- Skill: greedy>maxpower 59.6% (n=146), lookahead-lite>greedy 70.0% (n=100), greedy>random 80.8% (n=104)
|
||||
|
||||
| starters (row vs col) | field-guide | headliners | pioneers | stargazers | vs all decks |
|
||||
|---|---|---|---|---|---|
|
||||
| field-guide | – | 60% (n=52) | 51% (n=53) | 51% (n=55) | 50.1% |
|
||||
| headliners | 40% (n=52) | – | 41% (n=56) | 41% (n=54) | 48.3% |
|
||||
| pioneers | 49% (n=53) | 59% (n=56) | – | 55% (n=58) | 54.2% |
|
||||
| stargazers | 49% (n=55) | 59% (n=54) | 45% (n=58) | – | 54.1% |
|
||||
|
||||
| owned (random 12 from card-sample) vs | field-guide | headliners | pioneers | stargazers | all |
|
||||
|---|---|---|---|---|---|
|
||||
| owned-0 | 46% | 43% | 46% | 49% | 43.8% |
|
||||
| owned-1 | 50% | 43% | 40% | 34% | 44.1% |
|
||||
| owned-2 | 52% | 47% | 56% | 51% | 52.7% |
|
||||
| owned-3 | 63% | 49% | 43% | 42% | 52.4% |
|
||||
| **all owned** | **52%** (n=233) | **45%** (n=198) | **46%** (n=198) | **43%** (n=199) | |
|
||||
|
||||
|
||||
| keyword | power per card | games decided by it | cards played |
|
||||
|---|---|---|---|
|
||||
| rising | +1.71 | 12.8% | 1505 |
|
||||
| nostalgic | +1.68 | 13.6% | 1789 |
|
||||
| translated | +1.64 | 17.6% | 4491 |
|
||||
| local | +0.70 | 6.3% | 4081 |
|
||||
| encyclopedic | +0.21 | 1.7% | 2177 |
|
||||
| viral | +0.13 | 0.9% | 2524 |
|
||||
|
||||
#### `v1.1-critic-nerf`: 2000 matches, 14 draws, 0 engine errors
|
||||
|
||||
- First player (turn-1 initiative), symmetric games: **51.0% [48.6–53.4] (n=1636)**
|
||||
- Decided early: 4.0% of decisive games locked in during the first third, 12.7% by half-time
|
||||
- Skill: greedy>maxpower 58.2% (n=146), lookahead-lite>greedy 66.0% (n=100), greedy>random 79.8% (n=104)
|
||||
|
||||
| starters (row vs col) | field-guide | headliners | pioneers | stargazers | vs all decks |
|
||||
|---|---|---|---|---|---|
|
||||
| field-guide | – | 49% (n=51) | 50% (n=52) | 55% (n=55) | 50.6% |
|
||||
| headliners | 51% (n=51) | – | 50% (n=54) | 46% (n=54) | 55.3% |
|
||||
| pioneers | 50% (n=52) | 50% (n=54) | – | 47% (n=58) | 51.8% |
|
||||
| stargazers | 45% (n=55) | 54% (n=54) | 53% (n=58) | – | 51.9% |
|
||||
|
||||
| owned (random 12 from card-sample) vs | field-guide | headliners | pioneers | stargazers | all |
|
||||
|---|---|---|---|---|---|
|
||||
| owned-0 | 51% | 43% | 52% | 46% | 46.0% |
|
||||
| owned-1 | 40% | 35% | 47% | 33% | 43.1% |
|
||||
| owned-2 | 52% | 42% | 37% | 56% | 51.1% |
|
||||
| owned-3 | 58% | 38% | 47% | 55% | 50.1% |
|
||||
| **all owned** | **50%** (n=231) | **40%** (n=197) | **46%** (n=199) | **47%** (n=197) | |
|
||||
|
||||
|
||||
| keyword | power per card | games decided by it | cards played |
|
||||
|---|---|---|---|
|
||||
| rising | +1.72 | 15.6% | 1534 |
|
||||
| translated | +1.69 | 16.3% | 4315 |
|
||||
| nostalgic | +1.66 | 13.3% | 1686 |
|
||||
| local | +0.71 | 6.4% | 4113 |
|
||||
| encyclopedic | +0.21 | 1.8% | 2221 |
|
||||
| viral | +0.13 | 0.7% | 2571 |
|
||||
|
||||
|
||||
|
||||
#### Critic package, full field (3,000 matches)
|
||||
|
||||
#### `v1.1-critic`: 3000 matches, 14 draws, 0 engine errors
|
||||
|
||||
- First player (turn-1 initiative), symmetric games: **49.7% [47.7–51.7] (n=2418)**
|
||||
- Decided early: 8.0% of decisive games locked in during the first third, 17.9% by half-time
|
||||
- Skill: greedy>maxpower 54.6% (n=238), lookahead-lite>greedy 62.7% (n=161), greedy>random 84.0% (n=169)
|
||||
|
||||
| starters (row vs col) | field-guide | headliners | pioneers | stargazers | vs all decks |
|
||||
|---|---|---|---|---|---|
|
||||
| field-guide | – | 38% (n=8) | 50% (n=8) | 29% (n=7) | 60.6% |
|
||||
| headliners | 62% (n=8) | – | 36% (n=11) | 56% (n=9) | 46.8% |
|
||||
| pioneers | 50% (n=8) | 64% (n=11) | – | 50% (n=12) | 59.7% |
|
||||
| stargazers | 71% (n=7) | 44% (n=9) | 50% (n=12) | – | 64.8% |
|
||||
|
||||
| owned (random 12 from card-sample) vs | field-guide | headliners | pioneers | stargazers | all |
|
||||
|---|---|---|---|---|---|
|
||||
| owned-0 | 33% | 64% | 36% | 50% | 55.3% |
|
||||
| owned-1 | 50% | 50% | 33% | 43% | 54.9% |
|
||||
| owned-2 | 55% | 58% | 27% | 42% | 52.7% |
|
||||
| owned-3 | 11% | 42% | 9% | 50% | 52.8% |
|
||||
| **all owned** | **38%** (n=37) | **54%** (n=41) | **26%** (n=39) | **46%** (n=37) | |
|
||||
|
||||
| archetype | WR vs other decks |
|
||||
|---|---|
|
||||
| curve | 58.6% [51.7–65.2] (n=203) |
|
||||
| top-heavy | 52.2% [45.4–58.9] (n=205) |
|
||||
| heavy | 23.4% [18.1–29.7] (n=205) |
|
||||
| swarm | 0.9% [0.2–3.3] (n=220) |
|
||||
| mono-Culture | 55.4% [48.9–61.6] (n=233) |
|
||||
| mono-People | 47.5% [41.0–54.1] (n=221) |
|
||||
| mono-Nature | 40.3% [34.0–46.9] (n=216) |
|
||||
|
||||
| keyword | power per card | games decided by it | cards played |
|
||||
|---|---|---|---|
|
||||
| rising | +1.74 | 21.1% | 3184 |
|
||||
| translated | +1.59 | 15.8% | 3450 |
|
||||
| nostalgic | +1.58 | 19.7% | 2871 |
|
||||
| local | +0.66 | 7.5% | 4696 |
|
||||
| encyclopedic | +0.23 | 2.0% | 4548 |
|
||||
| viral | +0.16 | 1.5% | 4733 |
|
||||
|
||||
|
||||
|
||||
### v1 full-field detail
|
||||
|
||||
#### `v1` (DEFAULT_RULESET): 3000 matches, 13 draws, 0 engine errors
|
||||
|
||||
- First player (turn-1 initiative), symmetric games: **51.5% [49.6–53.5] (n=2421)**
|
||||
- Decided early: 6.5% of decisive games locked in during the first third, 19.9% by half-time
|
||||
- Skill: greedy>maxpower 59.5% (n=237), lookahead-lite>greedy 63.7% (n=160), greedy>random 77.5% (n=169)
|
||||
|
||||
| starters (row vs col) | field-guide | headliners | pioneers | stargazers | vs all decks |
|
||||
|---|---|---|---|---|---|
|
||||
| field-guide | – | 70% (n=10) | 57% (n=7) | 83% (n=6) | 67.4% |
|
||||
| headliners | 30% (n=10) | – | 33% (n=12) | 56% (n=9) | 51.7% |
|
||||
| pioneers | 43% (n=7) | 67% (n=12) | – | 64% (n=14) | 67.0% |
|
||||
| stargazers | 17% (n=6) | 44% (n=9) | 36% (n=14) | – | 53.3% |
|
||||
|
||||
| owned (random 12 from card-sample) vs | field-guide | headliners | pioneers | stargazers | all |
|
||||
|---|---|---|---|---|---|
|
||||
| owned-0 | 29% | 40% | 15% | 58% | 51.0% |
|
||||
| owned-1 | 33% | 33% | 67% | 56% | 51.6% |
|
||||
| owned-2 | 27% | 62% | 62% | 25% | 59.7% |
|
||||
| owned-3 | 43% | 50% | 56% | 70% | 57.7% |
|
||||
| **all owned** | **31%** (n=42) | **48%** (n=48) | **44%** (n=36) | **51%** (n=43) | |
|
||||
|
||||
| archetype | WR vs other decks |
|
||||
|---|---|
|
||||
| curve | 50.0% [43.5–56.5] (n=222) |
|
||||
| top-heavy | 56.8% [50.2–63.1] (n=222) |
|
||||
| heavy | 15.3% [11.0–20.9] (n=203) |
|
||||
| swarm | 2.0% [0.9–4.6] (n=250) |
|
||||
| mono-Culture | 42.2% [35.7–48.9] (n=211) |
|
||||
| mono-People | 51.7% [44.9–58.4] (n=207) |
|
||||
| mono-Nature | 56.0% [49.6–62.3] (n=232) |
|
||||
|
||||
| keyword | power per card | games decided by it | cards played |
|
||||
|---|---|---|---|
|
||||
| rising | +1.76 | 15.6% | 4027 |
|
||||
| translated | +1.53 | 17.5% | 1266 |
|
||||
| nostalgic | +1.45 | 16.4% | 3610 |
|
||||
| local | +0.65 | 6.1% | 6781 |
|
||||
| viral | +0.19 | 2.3% | 8030 |
|
||||
| encyclopedic | +0.19 | 1.4% | 1002 |
|
||||
|
||||
|
||||
*Starter-vs-starter cells here have small n; the focused round robin above has the real numbers. Keyword table: counterfactual trigger value per card (excluding any powerDelta).*
|
||||
|
||||
|
||||
### Lever sweeps (greedy mirrors, real pool)
|
||||
|
||||
Before keywords were implemented (engine core @ c938407), I swept these levers. Each row is 3,000 greedy-mirror games. Columns are win rate vs the other decks.
|
||||
|
||||
| variant | heavy | swarm | curve | first player |
|
||||
|---|---|---|---|---|
|
||||
| v1 | 11.9% | 0.9% | 64.5% | 50.5% |
|
||||
| `energyCarryMax 2` | 17.8% | 0.9% | 59.3% | 51.0% |
|
||||
| `energyByTurn [2..7]` | **42.4%** | 0.0% | 41.3% | 49.7% |
|
||||
| `powerByCost [0,2,3,4,6,8,10]` | 8.1% | 13.4% | 65.6% | 49.3% |
|
||||
| `powerByCost [0,2,4,5,7,8,10]` | 0.3% | **36.1%** | 62.1% | 49.7% |
|
||||
| `laneCapacity 4` | 10.3% | 0.6% | 63.6% | 50.7% |
|
||||
| `onTopicBonus [0,2,2,2,2,3,3]` | 10.2% | 6.8% | 62.2% | 49.7% |
|
||||
|
||||
**Reading:** energy 2→7 rescues heavy but kills swarm and curve, and flatter power rescues swarm but kills heavy. Neither helps the normal decks. Keep v1's curve.
|
||||
|
||||
### Caveats
|
||||
- Bots aren't people. Greedy doesn't plan energy carry and queues one card at a time; lookahead-lite is shallow.
|
||||
- Hidden cards in determinizations are sampled from the loaner pool, not from the opponent's real decklist.
|
||||
- Some critic-package items need engine hooks that don't exist yet, so this run approximates them:
|
||||
|
||||
| item | modelled as | exact? |
|
||||
|---|---|---|
|
||||
| viral base +1 | `powerDelta +1` | yes |
|
||||
| encyclopedic "your side only" | `powerDelta +1`, about the critic's measured +0.9 | no: an approximation until engine-b adds `encyclopedic {sides 1}` |
|
||||
|
||||
`powerDelta > 0` is a sim stand-in: the engine's derivation clamps `powerDelta` to [−3, 0].
|
||||
- Owned decks are 4 random 12-card draws, not curated. They have no curve fill, so some are lopsided.
|
||||
|
||||
|
||||
## Method
|
||||
|
||||
**Engine.** Every match runs on the real rules engine (`shared/game`, public `index.ts` API only), through
|
||||
`shared/bots/game-adapter.ts`. Nothing in the sim re-implements rules. The engine commit is named in each
|
||||
results section.
|
||||
|
||||
**Bots** (`shared/bots/index.ts`, each a pure `(state, player, rng) => action`):
|
||||
- `random`: a uniformly random legal play or commit.
|
||||
- `maxpower`: always queues the highest printed-power card it can afford, in a random legal lane. This is the
|
||||
DESIGN §8 "always play the highest-power card" line.
|
||||
- `greedy`: one-ply. It takes the action whose result scores best on a lane heuristic: a soft lead per Topic
|
||||
plus total power. The heuristic sees the bot's own queued plays and the opponent's *revealed* cards only.
|
||||
- `lookahead-lite` / `lookahead`: flat Monte Carlo over the top 3–4 greedy candidates, with 4–8 rollouts
|
||||
each. Before each rollout, the opponent's queued plays are taken back and its hand and deck reshuffled
|
||||
(determinization), so the bot never reads hidden information.
|
||||
|
||||
**Seats.** Plans are simultaneous: seat 0 queues and commits, then seat 1. Neither bot can see the other's
|
||||
queue, so the order leaks nothing. "First player" means the seat with **initiative on turn 1**.
|
||||
|
||||
**Schedule.** Per ruleset, matches are drawn from a fixed mix of bot pairings with random seats:
|
||||
|
||||
| pairing | share | used for |
|
||||
|---|---|---|
|
||||
| greedy vs greedy | 55% | balance (decks, cards, keywords, first player) |
|
||||
| lookahead-lite vs lookahead-lite | 12% | balance with a stronger player |
|
||||
| random vs random | 5% | baseline |
|
||||
| greedy vs lookahead-lite, maxpower vs lookahead-lite, maxpower vs greedy, random vs greedy | 28% | skill expression |
|
||||
|
||||
Deck, card and keyword statistics use only **bot-symmetric** games (the same bot on both seats). Deck pairs are
|
||||
drawn uniformly, mirrors included; the per-deck win rate excludes mirrors. `--mix fast` (greedy only) is used for
|
||||
quick lever sweeps.
|
||||
|
||||
**Decks.** These are built from a card pool by `defaultDecks()`:
|
||||
- 6 seeded starter decks (`starterDeck`)
|
||||
- `curve` (cost counts 2/3/3/2/1/1)
|
||||
- `top-heavy` (1/1/2/2/3/3)
|
||||
- `heavy` (cost 5–6 first: the §8 "all-famous" line)
|
||||
- `swarm` (cost ≤ 2 first)
|
||||
- `mono-<faction>` curve decks for factions with ≥ 6 cards
|
||||
- `kw-<keyword>` curve decks for keywords on ≥ 3 cards
|
||||
|
||||
The pool is the engine's preview pool, or council-data's `card-sample.json` derived per DESIGN §1
|
||||
(percentile → fame → cost, home stat, faction keyword). Loaner power always follows the ruleset's
|
||||
`powerByCost`.
|
||||
|
||||
**Metrics.**
|
||||
- Win rates with Wilson 95% intervals. **↑/↓** marks an interval that excludes 50%.
|
||||
- First-player WR: initiative holder on turn 1, symmetric games.
|
||||
- Match length in turns.
|
||||
- "Decided early": the turn from which the eventual winner led on the heuristic until the end, as a fraction of
|
||||
the match.
|
||||
- Per-card WR: the win rate of the side that played the card.
|
||||
- Per-stat correlations.
|
||||
- **Keyword value:** a counterfactual. Each finished match is replayed with the same actions and the keyword
|
||||
removed from one side. We report the side's lost total power per keyword card, and how often removing the
|
||||
keyword made the result worse for that side ("games decided by it"). DESIGN §10.1 asks for
|
||||
`keywordParams.<id>.powerDelta` when a keyword is worth more than about 1 power.
|
||||
|
||||
**Reproduce.**
|
||||
```
|
||||
SIM_POOL=docs/game/card-sample.json SIM_RULESETS=scripts/sim/variants/v1.json \
|
||||
npx tsx scripts/sim/run.ts --engine game --matches 5000 --workers 10 --out sim-out
|
||||
python3 scripts/sim/summary.py sim-out
|
||||
```
|
||||
|
||||
**Limits.**
|
||||
- Bots are not humans. Greedy undervalues saving energy and bluffing.
|
||||
- Lookahead rollouts are short.
|
||||
- Deck archetypes are built automatically, not tuned by hand.
|
||||
- The 100-card sample is skewed: Culture 53, People 30, Nature 9, History 5, Science 3, Space 0.
|
||||
@@ -0,0 +1,149 @@
|
||||
# Card data: real stat distributions (council-data)
|
||||
|
||||
Status: **final for tonight**, 236 fully enriched cards, generated 2026-11-16 23:20 EST. Sampling stopped early on night-lead's request because Wikimedia was rate-limiting (429) our shared egress IP. 330 cards were picked; the first 236 finished enrichment.
|
||||
|
||||
**Method:** `scripts/night/card_sample.py` draws random ns0 articles in batches of 20 and keeps those that pass the `server/wiki.ts` filter: a thumbnail from upload/thumb.wikimedia.org and an intro extract of at least 40 characters. About 44% of random pages pass. Each card is enriched with the same API parameters as `server/enrichment.ts`:
|
||||
- six completed months, Jun–Oct 2026; attention uses October
|
||||
- monthly views summed from the daily REST pageviews
|
||||
|
||||
On top of that it adds Wikidata P31 and a 30-day drift (views 10-17..11-15 vs 09-17..10-16).
|
||||
|
||||
**Politeness:** the sampler runs serially at 1 request a second or slower, honours Retry-After, and caches every response to disk. `scripts/night/card_analyze.py` produces everything below, plus the `percentiles` (99 cut points each, for DESIGN §1.1) in `card-sample.json`.
|
||||
|
||||
## Files
|
||||
- `card-sample.json`: `cards[]` with the `PageEnrichment` shape, plus `category` (legacy `category()`), `instanceOf` (P31), `faction` (the P31 rules below), `tiers` and `drift30`. Top level: `percentiles`, `tierBreakpoints`, `factionRules` and `note`.
|
||||
- `starter-cards.json`: the loaner **pool**, 20 real frozen snapshots (a `MintStatsSnapshot` in `snapshot`). It also holds `starterDeckPageIds`: the 48 DESIGN §2.1 starter titles with their real pageIds and `cardId`s.
|
||||
|
||||
## Headline findings (236 cards)
|
||||
1. **Raw scores are compressed.**
|
||||
|
||||
| score | median | p10–p90 | max |
|
||||
|---|---|---|---|
|
||||
| attention | 32 | 20–53 | 77 |
|
||||
| depth | 63 | 54–73 | 87 |
|
||||
| reach | 20 | 0–45 | 70 |
|
||||
|
||||
No honest card reaches 100. Use `percentiles` (§1.1) or the 1–10 tiers, never the raw 0–100 values.
|
||||
2. **Correlations (Spearman):**
|
||||
- attention and depth: 0.61, so these two double-count fame
|
||||
- reach is nearly independent of both (0.17 with attention, 0.02 with depth)
|
||||
3. **Reach has a hard floor:** 18% of cards (42) have 0 other languages, so reach is 0. Under the §1.1 counting, all of them get pct_reach of about 8.
|
||||
4. **Raw values are long-tailed:**
|
||||
|
||||
| value | median | p90 | max |
|
||||
|---|---|---|---|
|
||||
| monthly views | 82 | 1,576 | 42k |
|
||||
| pageBytes | 6.1 KB | 24 KB | |
|
||||
| languageCount | 3 | 22 | |
|
||||
5. **Trend is mostly down:**
|
||||
- 65% of cards have a negative trendPercent, 34% positive; median −9.5%
|
||||
- 16% swing by more than 50% either way
|
||||
- null: 1%
|
||||
6. **Live drift is small in score terms.** The 30-day median |pageview drift| is 22% (p90 60%). That moves attention by only **1.7 points** (p90 6.3), so at-mint and live values differ little unless someone inflates them.
|
||||
7. **The legacy `category()` split is very skewed:**
|
||||
|
||||
| category | share |
|
||||
|---|---|
|
||||
| Culture | 56% |
|
||||
| People | 26% |
|
||||
| Nature | 8% |
|
||||
| History | 8% |
|
||||
| Science | 1% |
|
||||
| Space | 0.4% |
|
||||
8. **Candidate factions from P31:**
|
||||
|
||||
| faction | share |
|
||||
|---|---|
|
||||
| People | 29% |
|
||||
| Places | 20% |
|
||||
| Nature | 8% |
|
||||
| Structures | 7% |
|
||||
| Works | 5% |
|
||||
| Events | 5% |
|
||||
| Organisations | 4% |
|
||||
| Ideas & Tech | 3% |
|
||||
| Sport | 3% |
|
||||
| unclassified | 14% |
|
||||
|
||||
Suggested 6 for v2: People, Places, Nature, Works & Culture (Works + Organisations + Sport), Structures, Events & Ideas, plus a neutral fallback.
|
||||
|
||||
## Full tables
|
||||
|
||||
Sample: **236 cards**; ~44% (149/340 logged during sampling) of random pages pass the illustrated filter. Pageviews available for 236.
|
||||
|
||||
| stat | n | min | p10 | p25 | median | p75 | p90 | max | mean | skew |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| attention | 236 | 13 | 20 | 25 | 32 | 41 | 53 | 77 | 35 | 0.78 |
|
||||
| depth | 236 | 48 | 54 | 58 | 63 | 68 | 73 | 87 | 64 | 0.42 |
|
||||
| reach | 236 | 0 | 0 | 10 | 20 | 33 | 45 | 70 | 23 | 0.36 |
|
||||
| pageBytes | 236 | 772 | 1847 | 3084 | 6110 | 12805 | 24412 | 168332 | 11691 | 4.61 |
|
||||
| languageCount | 236 | 0 | 0 | 1 | 3 | 9 | 22 | 124 | 8 | 4.14 |
|
||||
| monthlyViews | 236 | 5 | 16 | 30 | 82 | 300 | 1576 | 42025 | 812 | 9.82 |
|
||||
| dailyAverage | 236 | 0.2 | 0.5 | 1.0 | 2.6 | 9.7 | 50.8 | 1355.6 | 26.2 | 9.82 |
|
||||
| trendPercent | 234 | -86.6 | -49.3 | -26.3 | -9.5 | 5.3 | 31.2 | 388.9 | -3.6 | 4.11 |
|
||||
| drift30Percent | 235 | -94.7 | -58.2 | -33.8 | -12.9 | 1.0 | 27.7 | 2268.7 | -4.2 | 14.07 |
|
||||
|
||||
**Spearman rank correlations** (cards with pageviews):
|
||||
|
||||
| | attention | depth | reach | trendPercent | drift30Percent |
|
||||
|---|---|---|---|---|---|
|
||||
| attention | 1.00 | 0.61 | 0.17 | 0.35 | 0.33 |
|
||||
| depth | 0.61 | 1.00 | 0.02 | 0.15 | 0.14 |
|
||||
| reach | 0.17 | 0.02 | 1.00 | 0.00 | 0.09 |
|
||||
| trendPercent | 0.35 | 0.15 | 0.00 | 1.00 | 0.31 |
|
||||
| drift30Percent | 0.33 | 0.14 | 0.09 | 0.31 | 1.00 |
|
||||
|
||||
(n=234; attention~monthlyViews, depth~pageBytes, reach~languageCount are monotonic so their rank correlations are identical.)
|
||||
|
||||
**trendPercent sign:** positive 79 (34%), negative 153 (65%), zero 2; null (prior month 0 or no views) 2. |trend| > 50%: 38; > 100%: 7.
|
||||
|
||||
**30-day drift** (views 10-17..11-15 vs 09-17..10-16): median |drift| 22%, p90 |drift| 60%. Attention score change implied: median 1.7 points, p90 6.3 points.
|
||||
|
||||
**attention histogram (deciles 0-9,10-19..90-100):** 0 19 74 74 36 20 12 1 0 0
|
||||
**depth histogram (deciles 0-9,10-19..90-100):** 0 0 0 0 2 72 117 38 7 0
|
||||
**reach histogram (deciles 0-9,10-19..90-100):** 42 60 53 43 21 15 1 1 0 0
|
||||
|
||||
Reach = 0 (no other languages): 42; reach 100 (>=999 langs) impossible in practice, max langs 124. Attention null: 0; attention 0: 0.
|
||||
|
||||
**Sum of three stats:** min 73, p10 89, p25 102, median 116, p75 135, p90 156, max 222
|
||||
|
||||
**Legacy `category()` (server/wiki.ts):** Culture 133, People 62, Nature 19, History 18, Science 3, Space 1
|
||||
|
||||
**Top Wikidata P31 classes:** human 64, taxon 16, village 7, commune of France 6, river 5, human settlement 4, musical group 3, building 3, gene 3, village of Poland 2, civil parish 2, protest 2, legislative election 2, castle 2, events in a specific year or time period 2, township of Pennsylvania 2, film 2, company 2, island 2, rural municipality of Austria 1, municipality of Austria 1, municipality of Brazil 1, television film 1, nor'easter 1, rail company (Japan) 1, municipality 1, association football match 1, final 1, local government area of Victoria 1, plant disease 1, basketball team season 1, mosque 1, functional programming language 1, purely functional programming language 1, dependently typed programming language 1, programming language 1, free software 1, proof assistant 1, municipality of Croatia 1, municipality of Bangladesh 1
|
||||
|
||||
No Wikidata item: 0; no P31: 13
|
||||
|
||||
**Most frequent category words (cards containing):** stubs 81, births 55, people 50, from 50, century 46, living 33, geography 30, american 29, deaths 28, united 27, county 27, states 23, established 21, establishments 20, alumni 18, places 17, university 16, buildings 16, state 15, national 14, structures 14, male 13, players 12, district 11, villages 11, sportsmen 11, members 11, described 10, football 10, sports 10, city 10, film 10, british 9, companies 9, populated 9, sportspeople 9, biography 9, york 9, women 8, taxa 8, germany 8, politicians 8, television 7, writers 7, french 7, genera 7, based 7, communes 7, language 7, expatriate 7, named 7, olympics 7, completed 7, historic 7, register 7, faculty 6, pennsylvania 6, civil 6, history 6, california 6
|
||||
|
||||
|
||||
## Rank-normalised tiers (1–10)
|
||||
|
||||
Tier = 1 + number of breakpoints the score is **>=**. Breakpoints are the sample deciles p10..p90 of the 0–100 score. Ties make some tiers thin (scores are integers).
|
||||
|
||||
| stat | p10 | p20 | p30 | p40 | p50 | p60 | p70 | p80 | p90 |
|
||||
|---|---|---|---|---|---|---|---|---|---|
|
||||
| attention | 20 | 24 | 27 | 30 | 32 | 35 | 39 | 44 | 53 |
|
||||
| depth | 54 | 57 | 59 | 61 | 63 | 65 | 67 | 69 | 73 |
|
||||
| reach | 0 | 10 | 10 | 16 | 20 | 26 | 30 | 36 | 45 |
|
||||
|
||||
Resulting tier counts — attention: None:0 1:19 2:27 3:24 4:23 5:23 6:17 7:28 8:25 9:22 10:28
|
||||
; depth: 1:14 2:23 3:26 4:21 5:25 6:26 7:22 8:21 9:30 10:28
|
||||
; reach: 1:0 2:42 3:0 4:30 5:30 6:32 7:21 8:27 9:27 10:27
|
||||
|
||||
|
||||
## Candidate factions (Wikidata P31 rules)
|
||||
|
||||
| faction | n | share | median attention | median depth | median reach | example |
|
||||
|---|---|---|---|---|---|---|
|
||||
| People | 68 | 29% | 31 | 65 | 22 | Salahuddin of Aceh |
|
||||
| Places | 48 | 20% | 28 | 61 | 32 | St. Georgen am Längsee |
|
||||
| Other | 34 | 14% | 40 | 65 | 16 | Village (Pennsylvania) |
|
||||
| Nature | 20 | 8% | 30 | 56 | 29 | Dichromorpha viridis |
|
||||
| Structures | 17 | 7% | 26 | 57 | 10 | Pathrail Mosque |
|
||||
| Works | 12 | 5% | 36 | 63 | 13 | The Best of Men |
|
||||
| Events | 12 | 5% | 40 | 72 | 13 | April 2021 nor'easter |
|
||||
| Organisations | 10 | 4% | 48 | 68 | 10 | Hiroshima Electric Railway |
|
||||
| Ideas & Tech | 8 | 3% | 30 | 63 | 16 | Agda (programming language) |
|
||||
| Sport | 7 | 3% | 27 | 70 | 16 | 1912 Argentine Primera División final |
|
||||
|
||||
Unclassified P31 labels: typeface 1, annexation 1, position 1, family 1, historic site 1, automobile manufacturer 1, historical society 1, stock character 1, pigeon breed 1, shopping center 1, Wikimedia list article 1, clinical sign 1, tram route 1, rubber-tyred tram 1, oil refinery 1, waterfall 1, orisha 1, water deity 1, Loa 1, arch 1, award 1, sex scandal 1, military base 1, artillery battery 1
|
||||
@@ -0,0 +1,673 @@
|
||||
# WikiDeck: Edit War — game design v1 (draft)
|
||||
|
||||
**Status:** v1 DRAFT, freeze target 23:30 EST 2026-11-16.
|
||||
**Owners:** council-designer-a owns sections 0–9 (research, card derivation, rules). council-designer-b
|
||||
owns sections 10–12 (keywords, peer-hosted modes, worked example). council-critic reviews.
|
||||
Every number in **`code font`** is a rules-config key (see §9). Modes can override any of them.
|
||||
|
||||
A two-player lane game for 3–6 minute matches. Each player has a 12-card deck and there are 3
|
||||
**Topics** (lanes) with 3 slots per side. There are 6 turns, both players plan at the same time, and
|
||||
energy ramps from 1 to 6, with 1 unspent energy carried over. Reveals interleave one card at a time.
|
||||
Win 2 of the 3 Topics. Each Topic is judged on one Wikipedia stat (**Attention**, **Depth** or
|
||||
**Reach**), and a card is stronger in a Topic that matches its best stat. Fame (how high a card's
|
||||
stats are overall) sets its **cost**, not its efficiency, so famous cards are sidegrades. They are
|
||||
not upgrades.
|
||||
|
||||
---
|
||||
|
||||
## 0. Research summary (what we took, what we left)
|
||||
|
||||
| Game | Why it's fun | Taken | Left |
|
||||
|---|---|---|---|
|
||||
| Marvel Snap | 3-minute matches; simultaneous turns; 3 lanes, so the decision is *where*, not just *what* | lanes, about 6 turns, simultaneous planning, small deck | stakes betting (modes only); we deliberately diverge in lane size (3), energy carry-over, interleaved alternating reveals, stats visible from turn 1 with hidden Portals, and on-topic tie-breaks |
|
||||
| Hearthstone | mana curve; readable cards; tempo | energy = turn number, curve-shaped costs | 30-card decks and 15-minute matches; hero powers |
|
||||
| Magic: The Gathering | factions (colours) with distinct identities; deckbuilding depth | 6 factions with their own keyword flavour | land screw (resource variance); the stack; long text |
|
||||
| Balatro | huge "moment" when a combo goes off; simple base rules plus modifiers | lane modifiers (Portals) as the run-to-run variety | single-player scoring |
|
||||
| Slay the Spire | readable intents; every card is a choice | open information about lane state and power | roguelike runs (could be a mode) |
|
||||
| Gwent | rows; best 2 of 3; passing and bluffing | best 2 of 3 Topics; hidden commitments | multi-round card advantage (too long) |
|
||||
| Pokémon TCG | type advantage | on-topic bonus (card stat matches lane stat) | energy attachment; coin flips |
|
||||
| Top Trumps | instantly understood: "my number beats yours" | lanes judged on one stat | picking the stat is solved play (always pick your best) |
|
||||
| Dominion | deck building as play | — (too long for 3–6 min) | — |
|
||||
|
||||
**What is ours, not borrowed:**
|
||||
- (a) each Topic is judged on one Wikipedia stat (the Top Trumps twist)
|
||||
- (b) cost comes from an article's fame instead of being printed
|
||||
- (c) a trend arrow driven by live pageviews
|
||||
- (d) a total-power and consensus tie-break instead of stakes betting
|
||||
- smaller choices: 3 slots per lane, 1 carried-over energy, interleaved reveals, and stats visible
|
||||
from turn 1 with hidden Portals
|
||||
|
||||
The core loop is a lanes game in the style of Snap. The Top Trumps twist is that each lane asks for
|
||||
one Wikipedia stat. That makes every stat matter and gives each turn its main decision: play the card
|
||||
on-topic for the bonus, or put it where the fight is.
|
||||
|
||||
---
|
||||
|
||||
## 1. Card derivation (card data → game card)
|
||||
|
||||
The engine never reads raw 0–100 stats as power. Every game card is derived **deterministically** from a
|
||||
`CardInput` that the match host freezes at match start:
|
||||
|
||||
```
|
||||
CardInput = { cardId, pageId, title, category, rarity,
|
||||
snapshot: MintStatsSnapshot, // at mint, immutable
|
||||
live: { trendPercent: number | null, dailyAverage: number | null }, // frozen at match start
|
||||
check: 'verified' | 'unverified' | 'unchecked' | 'loaner', // set by the host (§1.10)
|
||||
pinned?: { cost, home, faction } } // loaners only (§2.1): replaces §1.1–1.5
|
||||
```
|
||||
|
||||
### 1.1 Percentiles (rank-normalisation)
|
||||
For each stat `s` in {attention, depth, reach}, `pct_s` = the percentile (0–100, integer) of the card's
|
||||
snapshot score in the reference table `percentiles.<s>`. That table holds 99 ascending cut points from
|
||||
council-data's `docs/game/card-sample.json`.
|
||||
`pct_s` = the number of cut points strictly below the score, plus half the number equal to it, rounded
|
||||
down. A `null` attention gives `pct_attention = null`.
|
||||
|
||||
### 1.2 Fame → Cost
|
||||
`fame` = the integer mean (rounded half up) of the non-null percentiles.
|
||||
`cost` = 1 + the number of thresholds in `costThresholds` (5 ascending values, default
|
||||
`[26, 39, 51, 63, 78]` in v1.1) that are ≤ `fame`. So cost runs 1–6.
|
||||
**Thresholds are data, not guesses (v1.1).** `fame` is a *mean* of up to 3 percentiles, so it clusters
|
||||
around 50 even though each percentile is uniform. The v1.0 values `[15, 35, 55, 75, 90]` treated fame as
|
||||
uniform, so 82% of the pool landed on cost 2–4 (3/23/37/22/10/5 %). `costThresholds` is therefore set to
|
||||
the fame values at the **15/35/55/75/90 % points of the reference sample** (the same `card-sample.json`
|
||||
whose `percentiles` table §1.1 uses). That's the integer set that brings the sample's cost spread closest
|
||||
to the target 15/20/20/20/15/10 %. The v1.1 defaults come from the 236-card sample (fame 8–98) and
|
||||
give 13/20/22/20/15/10 %. Whenever council-data refreshes the sample, the percentile table and
|
||||
`costThresholds` are regenerated together and ship as one change. Pinned loaners (§2.1) are unaffected.
|
||||
|
||||
### 1.3 Power
|
||||
`power` = `powerByCost[cost]`, default `[_, 1, 2, 4, 6, 8, 10]` (cost 1 → 1 … cost 6 → 10). The
|
||||
critic's sim showed that heavy decks were too weak with `[…5,7,9]`.
|
||||
Power depends **only on cost**. Two cards of the same cost have the same base power, whatever their
|
||||
fame. Inflating stats (forged snapshots, template shopping) only moves a card up the curve. It never
|
||||
makes a card more efficient.
|
||||
|
||||
### 1.4 Home stat
|
||||
`home` = the stat with the highest `pct_s`. Ties are broken in this order: depth, reach, attention.
|
||||
Depth and reach are the hardest to inflate. A `null` stat can never be home.
|
||||
When a card is in a Topic whose stat equals its `home`, it gets **+`onTopicBonus[cost]`** power
|
||||
(default `[0, 1, 1, 2, 2, 3, 3]`, i.e. ⌈cost/2⌉).
|
||||
On-topic efficiency is then about 2 power per energy at every cost (2.0 / 1.5 / 2.0 / 1.75 / 2.0 / 2.0).
|
||||
Off-topic, cheap cards are weaker (1.0) than expensive ones (1.5). Cheap cards want their Topic, and
|
||||
big cards are flexible.
|
||||
|
||||
### 1.5 Faction
|
||||
`faction` = the card's `category` (Space, Nature, People, Science, History, Culture), from
|
||||
`server/wiki.ts`. Culture is about half the pool, so faction keywords are written so that a
|
||||
mono-faction deck gains no consistency edge (§10: no v1 keyword scales with faction count).
|
||||
|
||||
### 1.6 Trend (live, small, capped)
|
||||
`trend` = +1 if `live.trendPercent ≥ trendUp` (default 25), −1 if `≤ trendDown` (default **−200**,
|
||||
which means there is **no down arrow in v1**: 69% of cards trend negative, so a ▼ would mostly land as
|
||||
a quiet penalty on famous owned cards; modes can turn it back on), otherwise 0. A `null` value gives 0. Trend also needs `live.dailyAverage ≥ trendMinDaily` (default
|
||||
**20**), because percentages on tiny articles are noise; otherwise trend is 0. The host computes it **once at match start**, and it is frozen for
|
||||
the match. It shows as an arrow (▲), not a number. It adds to power in every Topic. *Why no ▼ by default:* 69% of the sample has a
|
||||
negative `trendPercent`, and only busy (mostly owned, famous) cards pass `trendMinDaily`, so a ▼ would quietly penalise collectors.
|
||||
Modes may turn it back on with e.g. `trendDown: -25`.
|
||||
|
||||
### 1.7 Rarity
|
||||
The hash-derived `rarity` (`shared/protocol.ts:38`) is **cosmetic in v1** (frame colour only). Mining luck must not
|
||||
become power or keyword choice.
|
||||
|
||||
### 1.8 Keyword
|
||||
Each card has at most **one** keyword: cost-1 cards are vanilla, and the others get their faction's keyword (§10.1).
|
||||
|
||||
### 1.9 Card face (phone)
|
||||
The card face shows **cost** (top-left), **power** (big, centre; the bonus shows as a "+N" badge on the home icon when the card is on-topic), a **home-stat icon**
|
||||
(📣 attention / 📚 depth / 🌐 reach), an optional trend arrow, and one keyword word. That is two
|
||||
numbers, plus the live lane power when the card is on the board.
|
||||
|
||||
### 1.10 Plausibility (anti-forgery, off-chain)
|
||||
When `verifyStats` is true (the default for hosted matches), the match host checks each owned card's
|
||||
snapshot before the match:
|
||||
`pageBytes` against that revision's byte size, `languageCount` ≤ the live count + 5, and views for the
|
||||
snapshot month within ±10 % of the pageviews API.
|
||||
A card that fails is played with its live values. The **host replaces `snapshot`** with a snapshot
|
||||
built from the live values (`deriveStats` on the live bytes, languages and views) **before** it builds
|
||||
the `CardInput`. The match log marks the card `unverified`.
|
||||
The engine does no I/O and only ever sees one version of each card.
|
||||
- **Caching:** results are cached per `(pageId, revisionId, snapshotMonth)`. They are immutable, so a
|
||||
cached pass or fail never expires. Live values for a failed card are cached for 24 h.
|
||||
- **Card can't be verified** (the pageId or revision doesn't exist, or the title or category doesn't
|
||||
match): the card is **rejected at deck validation**, and the player is asked to swap in a loaner.
|
||||
- **API failure:** if Wikipedia can't be reached and nothing is cached, the card plays from its snapshot
|
||||
with `check: 'unchecked'`. The engine then caps its cost at `uncheckedCostCap` (default **4**), and
|
||||
power follows the capped cost. Matches are never blocked.
|
||||
- The engine's only use of `check` is that cost cap. Loaner cards are `check: 'loaner'`.
|
||||
|
||||
---
|
||||
|
||||
## 2. Decks
|
||||
|
||||
- **Deck size:** exactly `deckSize` cards (default **12**).
|
||||
- **Copies:** at most `maxCopiesPerPage` cards with the same `pageId` (default **2**). Owned and loaner
|
||||
copies count **together**. Each copy keeps its own snapshot, so the two copies may differ in cost.
|
||||
- **Deck validation** (engine): the size is right, the copy limit holds, every card's `check` is
|
||||
valid, and there are no more loaners than `maxLoaners`. An invalid deck can't start a match.
|
||||
- **Owned cards:** any card the player's wallet owns at match start. Ownership is read off-chain. The
|
||||
match never moves, locks or burns a card.
|
||||
- **Loaner cards:** off-chain preview cards with a fixed `CardInput`, shipped with the game data
|
||||
(`docs/game/starter-cards.json`, picked by council-data: about 24 pageIds across all 6 categories,
|
||||
with frozen, hand-checked snapshot stats, including the 4 cards in `shared/catalog.ts`).
|
||||
Loaners follow the same curve (§2.1 pins their cost, home and faction), so they are no weaker or stronger than owned cards.
|
||||
- **Starter decks:** `starterDecks` (default: 4 fixed 12-card loaner decks). Each one has two leading
|
||||
factions and an average cost of 3.0–3.3, and is **curve-shaped**: at least 3 cards of cost 4 or more,
|
||||
and at most 4 of cost 1. A new player picks one and can play at once.
|
||||
- **Mixed decks:** an owned deck may fill any slots with loaners, up to `maxLoaners` (default 12, which
|
||||
means no limit). Owning NFTs gives **variety**, not power: owned and loaner cards follow the same
|
||||
curve.
|
||||
|
||||
### 2.1 Starter decks v1 *(owner: council-designer-b)*
|
||||
|
||||
These are the default `starterDecks`: four 12-card loaner decks.
|
||||
- **Every deck has the same curve:** costs `1,1,2,2,3,3,3,4,4,5,5,6`. That's an average of 3.25, with 5 cards of cost 4 or more and 2 of cost 1.
|
||||
- **Every deck has the same shape:** 6 cards from each of two factions, and 4 cards for each home stat. So every deck can play on-topic in every lane.
|
||||
- **Loaner values are pinned.** Cost, home and faction are hand-set (not derived from `starter-cards.json`), so a loaner carries
|
||||
`pinned: { cost, home, faction }`. For `check: 'loaner'` the engine takes these instead of §1.1–1.5.
|
||||
Everything after them still applies: `powerByCost`, `onTopicBonus`, `vanillaBonus`, the §10.1 keyword choice and `keywordParams`.
|
||||
A mode that changes those numbers changes loaners exactly as it changes owned cards.
|
||||
- **Pinned cost isn't fame.** Cost was set by hand to fit the curve, not from the article's fame. Rarity is `Common` (frame only) and trend is 0.
|
||||
- **Loaner ids:** `cardId` = `loaner:<kebab-title>`, and `pageId` = the article's real pageId (v1 pins the 4 `shared/catalog.ts` ones: Moon 19331, Periodic table 23053, Octopus 22780,
|
||||
Albert Einstein 736; the rest are filled in from one batched API call in v1.1, `null` until then). The copy limit counts per `pageId`
|
||||
together with owned copies (§2); a loaner with `pageId: null` counts per `cardId`.
|
||||
- **Relation to `docs/game/starter-cards.json`** (council-data, real frozen snapshots of random articles): that file is the
|
||||
**loaner pool** for the sim and for "fill a slot with a loaner" in the deck builder. It is **not** the default starter decks.
|
||||
The decks below pin their values on purpose, for two reasons. Famous, recognisable articles would all derive to cost 5–6.
|
||||
And the random sample has no Space cards (CARD_DATA.md finding 6).
|
||||
- **v1.1 note (factions):** CARD_DATA.md finding 6 shows the legacy `category()` split as Culture 53%, People 30%, Nature 9%,
|
||||
History 5%, Science 3%, Space 0%. In v1, owned decks were therefore about 50% viral and 30% local. Viral was the weakest keyword, so a typical owned deck
|
||||
may be *weaker* than the starter decks. That's the wrong way round for "NFTs give variety, not power". v1 ships as is.
|
||||
For v1.1, sim-balance runs a **realistic owned deck** (12 cards drawn from `card-sample.json` with its real category mix)
|
||||
against each starter. **v1.1 fix:** viral gets a base of +1, and Culture cards take a keyword by home stat (§10.1), so owned decks
|
||||
now have all six keywords in the mix. **BALANCE.md v1.1:** starters 52–53% overall, and owned vs starters 42–51%
|
||||
(weakest vs Headliners and Stargazers; v1.2 candidates: `nostalgic`/`translated` `powerDelta -1`, `local.amount 2`). The P31-based factions council-data proposes (People, Places, Nature, Works & Culture,
|
||||
Structures, Events & Ideas) are the v2 fix, and would need the host to fetch P31 (it isn't in `PageEnrichment`).
|
||||
|
||||
Keywords follow from §10.1: cost 1 → vanilla, otherwise the faction keyword (shown in brackets).
|
||||
|
||||
**A. Stargazers: Space (translated) + Science (encyclopedic)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Moon | Space | reach |
|
||||
| 1 | Electron | Science | depth |
|
||||
| 2 | Mars | Space | attention |
|
||||
| 2 | Periodic table | Science | depth |
|
||||
| 3 | Saturn | Space | reach |
|
||||
| 3 | Photosynthesis | Science | attention |
|
||||
| 3 | Black hole | Space | depth |
|
||||
| 4 | Quantum mechanics | Science | reach |
|
||||
| 4 | Milky Way | Space | attention |
|
||||
| 5 | DNA | Science | attention |
|
||||
| 5 | Sun | Space | reach |
|
||||
| 6 | Theory of relativity | Science | depth |
|
||||
|
||||
**B. Field Guide: Nature (rising) + History (nostalgic)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Octopus | Nature | depth |
|
||||
| 1 | Stonehenge | History | attention |
|
||||
| 2 | Axolotl | Nature | attention |
|
||||
| 2 | Rosetta Stone | History | reach |
|
||||
| 3 | Coral reef | Nature | depth |
|
||||
| 3 | Roman Empire | History | reach |
|
||||
| 3 | Honey bee | Nature | attention |
|
||||
| 4 | Ancient Egypt | History | depth |
|
||||
| 4 | Amazon rainforest | Nature | reach |
|
||||
| 5 | Blue whale | Nature | attention |
|
||||
| 5 | Great Wall of China | History | reach |
|
||||
| 6 | World War II | History | depth |
|
||||
|
||||
**C. Headliners: People (local) + Culture (by home stat: attention → viral, depth → encyclopedic, reach → translated)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Haiku | Culture | attention |
|
||||
| 1 | Ada Lovelace | People | depth |
|
||||
| 2 | Jazz | Culture | attention |
|
||||
| 2 | Marie Curie | People | reach |
|
||||
| 3 | Mona Lisa | Culture | reach |
|
||||
| 3 | Frida Kahlo | People | attention |
|
||||
| 3 | Chess | Culture | depth |
|
||||
| 4 | Leonardo da Vinci | People | reach |
|
||||
| 4 | The Beatles | Culture | attention |
|
||||
| 5 | William Shakespeare | People | depth |
|
||||
| 5 | Olympic Games | Culture | reach |
|
||||
| 6 | Wolfgang Amadeus Mozart | People | depth |
|
||||
|
||||
**D. Pioneers: People (local) + Space (translated)**
|
||||
| Cost | Card | Faction | Home |
|
||||
|---|---|---|---|
|
||||
| 1 | Sputnik 1 | Space | reach |
|
||||
| 1 | Nikola Tesla | People | attention |
|
||||
| 2 | Hubble Space Telescope | Space | depth |
|
||||
| 2 | Isaac Newton | People | reach |
|
||||
| 3 | Neil Armstrong | People | attention |
|
||||
| 3 | Jupiter | Space | reach |
|
||||
| 3 | Galileo Galilei | People | depth |
|
||||
| 4 | Albert Einstein | People | attention |
|
||||
| 4 | International Space Station | Space | depth |
|
||||
| 5 | Apollo 11 | Space | attention |
|
||||
| 5 | Charles Darwin | People | reach |
|
||||
| 6 | Solar System | Space | depth |
|
||||
|
||||
- **Coverage:** all 6 factions appear, and all 4 `shared/catalog.ts` cards are included (Moon, Periodic table, Octopus, Albert Einstein).
|
||||
- **Tutorial:** Field Guide vs Stargazers, seed 1, against the easy bot.
|
||||
- **sim-balance:** please run the 4 decks round robin first. The target is every pairing at 45–55%. If a pairing misses, retune by
|
||||
swapping home stats within a deck, never by changing the curve.
|
||||
|
||||
---
|
||||
|
||||
## 3. Board
|
||||
|
||||
- 3 **Topics** (lanes), numbered 1–3 from left to right (top to bottom in portrait).
|
||||
- Each Topic has a **stat** (attention, depth or reach) and an optional **Portal** modifier (§10.3).
|
||||
Topics have **no faction**. No v1 keyword counts factions: faction only picks the keyword.
|
||||
- Each player has at most `laneCapacity` cards per Topic (default **3**). That gives 9 slots per side,
|
||||
which caps cheap-card flooding and fits 3 cards across a 360 px phone.
|
||||
- **Topic pool:** `topicPool` is a list of Topics, each `{ id, name, stat, portal | null }`. The default
|
||||
pool has 9 Topics: 3 per stat, one plain and two with Portals. `pool_s` is the sub-list with stat
|
||||
`s`, in file order.
|
||||
- **Topic draw (exact):**
|
||||
- If `distinctStats` is true (the default): for each stat in the fixed order
|
||||
`[attention, depth, reach]`, pick `pool_s[floor(next() × len(pool_s))]`. That uses 3 `next()`
|
||||
calls. Then Fisher–Yates the 3 picks into lanes 1–3 (i = 2, 1; j = floor(next() × (i+1))), which
|
||||
uses 2 calls.
|
||||
- If `distinctStats` is false: Fisher–Yates the whole pool (i from n−1 down to 1) and take the first
|
||||
`topicCount` entries as lanes 1–3.
|
||||
- **Stats visible, Portals hidden:** every Topic's **stat** is face-up from turn 1. Its **Portal**
|
||||
modifier is face-down until the start of turn `portalReveal[i]` (default `[2, 3, 4]`). You always
|
||||
know where your card is on-topic, but not what twist a lane will get.
|
||||
|
||||
---
|
||||
|
||||
## 4. Match setup (deterministic)
|
||||
|
||||
1. The input is `{ seed: uint32, rules, players: [p0, p1] }`, and each player's input is
|
||||
`{ id, deck: CardInput[12] }`. Seat order is input order.
|
||||
2. RNG: **mulberry32(seed)**. Every random choice draws `next()` in this fixed order:
|
||||
1. shuffle p0's deck (Fisher–Yates, i from n−1 down to 1, j = floor(next() × (i+1)))
|
||||
2. shuffle p1's deck the same way
|
||||
3. draw and shuffle the Topics
|
||||
4. the initiative coin: p0 has initiative on odd turns if next() < 0.5, otherwise p1
|
||||
5. later random events (keywords only), in resolution order
|
||||
3. Each player draws `openingHand` cards (default **3**). There are no mulligans in v1
|
||||
(`mulligan: false`).
|
||||
4. **Seed fairness (hosted PvP):** commit–reveal. Each party *i* (host, p0, p1) sends
|
||||
`sha256(r_i)` for a random 32-byte `r_i`, then reveals `r_i` once all commits are in.
|
||||
`seed` = the first 4 bytes (big-endian uint32) of `sha256(r_host ‖ r_p0 ‖ r_p1)`.
|
||||
The host still relays the hidden plans, so hosted PvP trusts the host not to leak them.
|
||||
Local and bot matches use any seed.
|
||||
|
||||
---
|
||||
|
||||
## 5. Turn structure
|
||||
|
||||
The match lasts `turns` turns (default **6**, hard cap). Each turn has these phases:
|
||||
|
||||
1. **Start**
|
||||
- Reveal any Portal scheduled for turn *t* (resolve its "on reveal").
|
||||
- Each player's energy = `energyByTurn[t-1]` + carry + `bonusEnergy`. Carry is
|
||||
min(`energyCarryMax`, unspent energy from last turn), default max **1**. Saving one energy on
|
||||
turn 2 makes a turn-3 four-drop possible: a real tempo choice.
|
||||
- Each player draws 1 card if their deck isn't empty and their hand holds fewer than `handLimit`
|
||||
(default **7**) cards. Otherwise they don't draw. This includes turn 1, so the turn-1 hand is
|
||||
3 + 1 = 4 cards.
|
||||
- Order within Start: Portal reveal, then energy, then draw. The Underdog check (step 2) comes after
|
||||
all three.
|
||||
2. **Underdog check** (mode option, `underdog: false` by default, because it can be sandbagged). When
|
||||
it's on, from turn 2, a player who leads in 0 Topics while the opponent leads in ≥ 2 gets
|
||||
**+1 energy** this turn.
|
||||
3. **Plan** (simultaneous, hidden)
|
||||
- Each player queues an ordered list of plays `(handIndex, topic)`.
|
||||
- Total cost must be ≤ their energy, and each Topic needs room on that player's side.
|
||||
- Plays can be undone freely until **Commit**. Passing is an empty commit.
|
||||
- **Hidden means nothing leaks.** While you plan, the opponent's hand count and energy don't change
|
||||
visibly. Only the bare fact "opponent is ready" (`committed`) is shown. No queue count, no spent energy.
|
||||
- The turn timer is `turnSeconds` (default **25**). On timeout, whatever is queued is committed.
|
||||
4. **Reveal (interleaved)**
|
||||
- Plays reveal **one at a time, alternating**: the initiative player's 1st, the other player's
|
||||
1st, the initiative player's 2nd, and so on. When one player runs out, the rest of the other's
|
||||
reveal in order.
|
||||
- Each card enters its Topic and its "on reveal" effect resolves at once.
|
||||
- So the order in which you queue cards matters: lead with the card you want resolved first.
|
||||
- Energy is reserved when a card is queued. A queued play that is no longer legal at reveal (the
|
||||
lane is full, or a Portal rejects it) **fizzles**: the card stays in hand and its energy is lost.
|
||||
5. **End**
|
||||
- Recompute all Topic powers (§6).
|
||||
- End-of-turn effects resolve, the initiative player's first.
|
||||
- Initiative strictly **alternates** each turn (set by the coin in §4).
|
||||
- Plans are locked before anything reveals, so initiative gives away no information. It only
|
||||
decides the order of on-reveal effects. §10 includes keywords where that order matters.
|
||||
|
||||
A typical turn is: look at the lanes, tap a card, tap a Topic (×1–3), tap Commit. That is under 10
|
||||
seconds, done with one thumb, with no dragging.
|
||||
|
||||
---
|
||||
|
||||
## 6. Power and Topic control
|
||||
|
||||
- A card's **lane power** = `power` + (`onTopicBonus[cost]` if its home stat is the Topic's stat) + `trend`
|
||||
+ keyword and Portal modifiers. It is never below 0.
|
||||
- A player's **Topic power** = the sum of their cards' lane power in that Topic.
|
||||
- A player **leads** a Topic if their Topic power is strictly greater than the opponent's.
|
||||
- **Consensus tie-break:** if the powers are equal and > 0, the player with more **on-topic** cards
|
||||
there leads. If that is also equal, nobody leads. 0–0 has no leader.
|
||||
|
||||
---
|
||||
|
||||
## 7. Win conditions and tie-breaks
|
||||
|
||||
**Scoring** happens after the last turn's End phase (§5.5): every end-of-turn effect, including
|
||||
the last turn's, and every "at scoring" Portal resolves **before** Topics are judged. Then:
|
||||
1. The player who leads **more Topics** wins (2–1, 2–0, 1–0 and 3–0 all count).
|
||||
2. If they lead the same number of Topics: the higher **total power across all Topics** wins.
|
||||
3. If that is also equal: the match is a **draw**.
|
||||
|
||||
**Concede:** a player can concede at any time, and the opponent wins at once. A player who misses
|
||||
`afkTurns` timeouts in a row (default **2**) with nothing queued concedes.
|
||||
|
||||
---
|
||||
|
||||
## 8. Degenerate lines and why they fail (for the critic)
|
||||
|
||||
| Line | Why it isn't dominant |
|
||||
|---|---|
|
||||
| All-famous (all max-stat) deck | It becomes an all-cost-5/6 deck with four dead early turns. Cheap cards are more efficient **per energy**, expensive cards **per card**, and only 9 cards are seen per match (3 + 6 draws). So a pure cost-5/6 deck is **weak by design**: **BALANCE.md v1: 15%**, and no lever (power curve, energy ramp) fixes it without breaking curve or swarm decks. There is no hard deck rule; the deck builder warns below 4 cards of cost ≤ 2, and every starter is curve-shaped (§2.1). **Target met:** a **top-heavy curve** (half the deck at cost 4 or more) wins **57%** (target ≥ 40%). `energyByTurn [2..7]` was rejected for v1.1: it lifts heavy decks but kills swarm (20%). |
|
||||
| All-cheap flood (cost 1–2) | Weak by design: only 9 slots and 9 cards seen. **BALANCE.md v1: 2%** (critic's sim 7–11%). Every lever that revives it breaks curve decks (sweep in BALANCE.md). viral (base +1, v1.1) is its consolation, not its fix. |
|
||||
| All one faction | No v1 keyword scales with faction count. `factionSynergyCap` is reserved for modes. Culture, the largest pool, splits over three keywords by home stat (§10.1), so it has no single keyword to stack. |
|
||||
| Owning NFTs buys power (pay-to-win) | Power depends only on cost (§1.3), and cost follows a fixed curve. **BALANCE.md v1.1 re-run (real `RULESET_V1_1`):** each starter deck averages **52–53%** overall. A realistic owned deck from `card-sample.json` wins **42–51%** against the starters (n ≈ 55 per pairing, ±13 pp). So owning cards buys variety, not power. v1.2 levers if owned decks should be a little stronger: `local.amount 2`, and `nostalgic`/`translated` `powerDelta -1` (the two strongest keywords, about +1.65 net per card). |
|
||||
| "Always play the highest-power card" | It ignores the on-topic bonus, lane capacity and the hidden Portals. **BALANCE.md v1:** the naive max-power line wins **40%** against greedy, and lookahead-lite beats greedy **60–70%**, so skill shows (target < 55%). Critic's sim: 18–21% against a smart bot. |
|
||||
| Stall or pass | Passing leaves lanes to any 1-power card. Two passing players draw. |
|
||||
| Mirror the AI | Hidden simultaneous commits: you only see the opponent's cards after you commit. |
|
||||
| Seat or initiative | Planning is simultaneous and initiative strictly alternates (each seat has it for 3 of the 6 turns). **BALANCE.md v1.1 re-run (real `RULESET_V1_1`): first player 51.2% [48.8–53.6]** (target 48–52%; v1 was 53.4%). |
|
||||
| Forged or shopped stats | They only raise cost (§1.3), the host check falls back to live stats (§1.10), and trend is capped at ±1. |
|
||||
| Inflated live pageviews | Worth at most +1, frozen at match start, and only counts for articles with ≥ 20 views a day. |
|
||||
| Swinginess | No effect may change a lane by more than 6 power or move cards between lanes in v1 (a keyword-design rule for §10). |
|
||||
|
||||
---
|
||||
|
||||
## 9. Rules config (all defaults)
|
||||
|
||||
The engine takes a `RulesConfig` object. Peer-hosted modes override it (§11). Defaults:
|
||||
|
||||
```json
|
||||
{
|
||||
"version": "1.1",
|
||||
"deckSize": 12, "maxCopiesPerPage": 2, "maxLoaners": 12,
|
||||
"openingHand": 3, "handLimit": 7, "mulligan": false,
|
||||
"turns": 6, "turnSeconds": 25, "afkTurns": 2,
|
||||
"energyByTurn": [1, 2, 3, 4, 5, 6], "energyCarryMax": 1, "bonusEnergy": 0, "underdog": false,
|
||||
"topicCount": 3, "distinctStats": true, "portalReveal": [2, 3, 4], "laneCapacity": 3,
|
||||
"topicPool": [ /* inline Topic objects {id, name, stat, portal}; default = the 9 in §10.3 */ ],
|
||||
"keywordParams": { /* per-keyword numbers, keyed by keyword id (§10) */ },
|
||||
"portalParams": { /* per-Portal numbers, keyed by Topic id (§10.3) */ },
|
||||
"costThresholds": [26, 39, 51, 63, 78],
|
||||
"powerByCost": [0, 1, 2, 4, 6, 8, 10],
|
||||
"onTopicBonus": [0, 1, 1, 2, 2, 3, 3], "vanillaBonus": 1,
|
||||
"keywordsEnabled": ["viral","rising","local","encyclopedic","nostalgic","translated"], "cultureKeyword": "home", "ownedCards": true,
|
||||
"trendUp": 25, "trendDown": -200, "trendMinDaily": 20, "uncheckedCostCap": 4,
|
||||
"factionSynergyCap": 3,
|
||||
"verifyStats": true,
|
||||
"percentiles": "card-sample-2026-11-16",
|
||||
"starterDecks": "default"
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
**What modes may vary:** every key above, plus `topicPool` contents and the starter-deck lists.
|
||||
**Fixed for all modes:** matches are off-chain and never move or burn NFTs; the RNG and its draw order
|
||||
(§4); the shape of the derivation (§1: percentile → fame → cost → power); at most one keyword per card;
|
||||
the phases of a turn (§5).
|
||||
A mode must keep `turns × turnSeconds ≤ 240` so that matches stay within 3–6 minutes.
|
||||
|
||||
---
|
||||
|
||||
## 10. Keywords *(owner: council-designer-b)*
|
||||
|
||||
**The v1 keyword set is these six, one per faction.** The ids are the ones engine-b already uses on `night/engine/keywords`.
|
||||
Topics carry only a **stat**, never a faction. Every keyword below that mentions a Topic keys off stats or board state.
|
||||
|
||||
### 10.1 Which keyword a card gets
|
||||
First rule that matches:
|
||||
1. `cost == 1` → **no keyword** (vanilla). The card gets +`vanillaBonus` power (default **1**), so a cost-1 card is 2.
|
||||
2. `"edition"` is in `keywordsEnabled` (off by default) and the deck holds another card with the same `pageId` → **edition**.
|
||||
3. If the faction is **Culture** and `cultureKeyword` is `"home"` (v1.1 default) → the keyword for its **home stat**:
|
||||
attention → **viral**, depth → **encyclopedic**, reach → **translated**. (`"faction"` gives v1 behaviour: every Culture card is viral.)
|
||||
4. Otherwise → the card's **faction keyword** from 10.2.
|
||||
|
||||
In steps 3–4, if the chosen keyword isn't in `keywordsEnabled`, the card is vanilla, *without* `vanillaBonus`.
|
||||
*Why step 3:* Culture is about half of all owned cards. Without it, owned decks are half viral and see only 2 of the 6 keywords.
|
||||
|
||||
Rarity plays no part here (it's cosmetic, §1.7). Keywords don't lower power, and v1 has no per-keyword power deltas.
|
||||
If sim shows that a keyword is worth more than about 1 power on average, sim-balance sets `keywordParams.<id>.powerDelta` (default 0, range −3 to 0).
|
||||
|
||||
### 10.2 Keyword list (v1)
|
||||
|
||||
| Faction | id (card word) | Trigger | Reminder text | Cap | Order-sensitive? |
|
||||
|---|---|---|---|---|---|
|
||||
| Culture | **viral** | On reveal | +1 power, plus +1 for each other card you revealed earlier this turn. | +3 | yes: your queue order |
|
||||
| Nature | **rising** | End of turn | +1 power. | +2 total | no |
|
||||
| People | **local** | Ongoing | +1 power while on-topic (the Topic's stat is its home stat). | +1 | no |
|
||||
| Science | **encyclopedic** | On reveal | +2 power if you have no other cards here. | +2 | **yes: interleaving** |
|
||||
| History | **nostalgic** | On reveal | +2 power if you are losing here. | +2 | **yes: interleaving** |
|
||||
| Space | **translated** | On reveal | +1 power to your most recently revealed card in each *other* Topic. | +2 | yes |
|
||||
|
||||
Why this set: every keyword is one line and one trigger, and only adds power. The largest swing is +2 on one card,
|
||||
so no lane moves by more than 3 from a keyword (viral at its cap). Nothing scales with faction count, so a mono-Culture deck gets no
|
||||
consistency edge (`factionSynergyCap` is unused). Viral rewards wide turns, and Culture cards are spread over three keywords (§10.1 step 3).
|
||||
Three keywords (encyclopedic, nostalgic, translated) react to the interleaved reveal (§5.4), so initiative and queue order matter.
|
||||
|
||||
Precise rules (for engine-b):
|
||||
- **On reveal** resolves the moment the card enters its Topic, and sees every card revealed before it (both players,
|
||||
including earlier reveals this turn). The bonuses it grants are permanent counters.
|
||||
- **Ongoing** is a condition, recalculated whenever power is read.
|
||||
- **End of turn** resolves in §5.5 order: the initiative player's cards first, then Topic 1→3, then reveal order.
|
||||
- **viral:** gain = min(`base` + `amount` × N, `cap`), where N = the owner's cards revealed earlier in *this* turn's Reveal phase, in any Topic.
|
||||
Cards that went back to hand don't count. v1.1: base 1, amount 1, cap 3 (v1 was base 0, cap 2).
|
||||
- **rising:** stops after it has gained +2 in total.
|
||||
- **local:** "on-topic" is exactly the §1.4/§6 condition. It's simply an extra +1 on top of `onTopicBonus`.
|
||||
- **encyclopedic:** with `sides: 1` (v1.1 default), "no other cards here" means **your** side of this Topic is empty, apart from this card,
|
||||
when it reveals; the opponent's cards don't matter. `sides: 2` is v1 (both sides empty).
|
||||
- **nostalgic:** "losing here" means the opponent's Topic power here is strictly greater than yours, counted just *before* this card is added.
|
||||
The consensus tie-break doesn't count: a tie is not losing.
|
||||
- **translated:** "most recently revealed" means the highest global reveal sequence number among your cards in that Topic. Topics where you have no card are skipped.
|
||||
- No v1 keyword uses the RNG. §4's "later random events" slot stays empty in v1.
|
||||
|
||||
**Already in code, disabled by default (`keywordsEnabled` excludes them; for modes only):**
|
||||
- **edition:** +2 for each other copy of this `pageId` on your side.
|
||||
- **obscure:** the opponent sees it face down until the end of the match.
|
||||
- **wildcard:** its home stat becomes the Topic's stat on reveal.
|
||||
|
||||
These are engine-b's existing implementations. The faction-based versions of `local` and `wildcard`, and the token version of `viral`, are
|
||||
**replaced** by the definitions above.
|
||||
|
||||
**`keywordParams` defaults** (keyed by keyword id; modes may change them within the §11 ranges):
|
||||
```json
|
||||
{ "viral": {"base": 1, "amount": 1, "cap": 3, "powerDelta": 0}, "rising": {"amount": 1, "cap": 2, "powerDelta": -1},
|
||||
"local": {"amount": 1, "powerDelta": 0}, "encyclopedic": {"amount": 2, "sides": 1, "powerDelta": 0},
|
||||
"nostalgic": {"amount": 2, "powerDelta": 0}, "translated": {"amount": 1, "powerDelta": 0},
|
||||
"edition": {"amount": 2, "powerDelta": 0}, "obscure": {"powerDelta": 0}, "wildcard": {"powerDelta": 0} }
|
||||
```
|
||||
End-of-turn effects on the last turn resolve **before** scoring (§7).
|
||||
|
||||
**v1.2 candidates** (not in v1.1; decide on a larger run, per BALANCE.md's v1.1 re-run): the keyword values are still uneven:
|
||||
translated +1.64 and nostalgic +1.69 per card vs local +0.69 (critic's target was ±0.3). The starter decks stay even only because each one
|
||||
pairs a strong keyword with a weak one. The first levers are `nostalgic.powerDelta -1` and `translated.powerDelta -1`, plus `local.amount 2`
|
||||
if owned decks stay under 45% against Headliners. Both are config only.
|
||||
|
||||
### 10.3 Portals (Topic modifiers) and the default Topic pool
|
||||
Each Topic has `{ id, name, stat, portal | null }`. The default `topicPool` has 9 Topics, one plain and two with
|
||||
Portals for each stat. A Portal applies from the moment its Topic is revealed (§3), except where it says otherwise.
|
||||
|
||||
| Topic | Stat | Portal rule |
|
||||
|---|---|---|
|
||||
| Current Events | attention | – |
|
||||
| Main Page | attention | At scoring, each card here gets +1 power. |
|
||||
| Trending | attention | Trend arrows (§1.6) count double here (±2). |
|
||||
| Archive | depth | – |
|
||||
| Featured Article | depth | At end of the match, the player with the single highest-power card here gets +2 Topic power here. If the highest card power here is tied (between the two players), nobody gets the bonus. |
|
||||
| Stub | depth | Lane capacity here is 2 per player. |
|
||||
| Translations | reach | – |
|
||||
| Interwiki | reach | +1 Topic power here for a player who has at least one card in all 3 Topics. |
|
||||
| Disambiguation | reach | Every card here counts as on-topic, whatever its home stat. |
|
||||
|
||||
As data: `portal = { kind: "scoringCardBonus", amount: 1 } | { kind: "trendMultiplier", factor: 2 } |
|
||||
{ kind: "highestCardBonus", amount: 2 } | { kind: "laneCapacity", value: 2 } | { kind: "spreadBonus", amount: 1 } |
|
||||
{ kind: "allOnTopic" }`. Modes may add Topics with these kinds, using new numbers, but not new kinds (engine code).
|
||||
|
||||
**`portalParams` defaults** (keyed by Topic id): `{ "main-page": {"amount": 1}, "trending": {"factor": 2},
|
||||
"featured-article": {"amount": 2}, "stub": {"value": 2}, "interwiki": {"amount": 1} }`. Disambiguation has no numbers.
|
||||
Topic ids are the names in kebab-case: `current-events, main-page, trending, archive, featured-article, stub,
|
||||
translations, interwiki, disambiguation`. The UI shows each Portal's one-line rule **on the lane itself**, not behind a tap.
|
||||
|
||||
---
|
||||
|
||||
## 11. Peer-hosted modes *(owner: council-designer-b)*
|
||||
|
||||
A **mode** is data, published by a node operator and run by the match host:
|
||||
```json
|
||||
{
|
||||
"id": "blitz", // [a-z0-9-]{3,32}, unique per host
|
||||
"name": "Blitz", "description": "Four quick turns.", // ≤ 40 and ≤ 280 chars, plain text
|
||||
"rules": { "turns": 4, "energyByTurn": [2, 3, 4, 5], "portalReveal": [1, 1, 2], "deckSize": 10 },
|
||||
"topicPool": [ /* optional: Topic objects (10.3); default if omitted */ ],
|
||||
"starterDecks": [ /* optional: lists of loaner pageIds */ ]
|
||||
}
|
||||
```
|
||||
- `rules` is a **partial** `RulesConfig` (§9) merged over the defaults. Unknown keys are rejected.
|
||||
- **Validation** (modes owns the code; these are the limits). If any check fails, the mode is refused:
|
||||
|
||||
| Key | Allowed |
|
||||
|---|---|
|
||||
| `turns` | 3–8, and `turns × turnSeconds ≤ 240` |
|
||||
| `energyByTurn` | length = `turns`, each 0–10 |
|
||||
| `bonusEnergy` | 0–3 |
|
||||
| `portalReveal` | length = `topicCount`, each 1..`turns`, non-decreasing |
|
||||
| `topicCount` | 1–5; `distinctStats` only if ≤ 3 |
|
||||
| `laneCapacity` | 1–6 |
|
||||
| `deckSize` | 6–20; `maxCopiesPerPage` 1–4; `maxLoaners` 0..`deckSize` |
|
||||
| `openingHand` | 0–6; `handLimit` 1–10 |
|
||||
| `turnSeconds` | 10–60; `afkTurns` 1–5 |
|
||||
| `costThresholds` | 5 strictly ascending integers in 0–100 |
|
||||
| `powerByCost` | 7 integers in 0–20, non-decreasing from index 1 |
|
||||
| `onTopicBonus` (7 entries), `vanillaBonus` | 0–5 each |
|
||||
| `trendUp` / `trendDown` | 0–200 / −200–0 |
|
||||
| `factionSynergyCap` | 0–6 |
|
||||
| `keywordsEnabled` | any subset of the 9 implemented ids (the 6 v1 defaults + edition, obscure, wildcard); a card whose keyword is disabled is vanilla, *without* `vanillaBonus` |
|
||||
| `keywordParams`, `portalParams` | only the keys listed in §10 / §10.3; amounts and caps 0–6, `viral.base` 0–3, `encyclopedic.sides` 1–2, `powerDelta` −3–0 |
|
||||
| `cultureKeyword` | `"home"` or `"faction"` |
|
||||
| `verifyStats` | the host may only turn this off for modes that use only loaners (`maxLoaners == deckSize` and owned cards banned) |
|
||||
| `topicPool` | 3–20 Topics, Portal kinds only from 10.3 |
|
||||
|
||||
- **Identity:** `modeHash` = SHA-256 of the canonical JSON (sorted keys, no whitespace) of the *merged* rules
|
||||
plus the topicPool. A match record holds `{ modeHash, seed, both decks' CardInputs, both players' commit lists }`,
|
||||
and that is enough to replay it exactly.
|
||||
- **What modes can't change** is the "Fixed for all modes" list in §9. Modes also can't add keywords or Portal kinds, or
|
||||
stake, move or burn NFTs.
|
||||
|
||||
Example modes (good defaults for operators to publish):
|
||||
| Mode | Overrides | Feel |
|
||||
|---|---|---|
|
||||
| **Blitz** | `turns 4`, `energyByTurn [2,3,4,5]`, `portalReveal [1,1,2]`, `deckSize 10`, `turnSeconds 20` | about 2 minutes |
|
||||
| **Deep Cuts** | `topicPool`: only the 3 depth Topics, `distinctStats false` | rewards long, obscure articles |
|
||||
| **Loaner League** | `maxLoaners 12` and owned cards banned (`"ownedCards": false`, a new boolean key, default true) | fully level, for tournaments |
|
||||
| **Big Board** | `topicCount 5`, `distinctStats false`, `portalReveal [1,2,3,4,5]`, `laneCapacity 3` | win 3 of 5; **tablet/desktop only** (5 × 3 slots won't fit a 360 px phone) |
|
||||
| **No Keywords** | `keywordsEnabled []`, `onTopicBonus [0,3,3,3,3,3,3]` | Top Trumps–style tutorial mode |
|
||||
|
||||
---
|
||||
|
||||
## 12. Worked example match *(owner: council-designer-b)*
|
||||
|
||||
**Ruleset for this example: v1.0** (the golden test pins it): `cultureKeyword "faction"`, `viral {base 0, cap 2}`,
|
||||
`encyclopedic {sides 2}`, `rising.powerDelta 0`; everything else as §9. *(The v1.1 numbers are in §12.1.)*
|
||||
|
||||
These are the §1–9 rules as of this PR:
|
||||
- `powerByCost [0,1,2,4,6,8,10]`, `onTopicBonus [0,1,1,2,2,3,3]`, `vanillaBonus 1`
|
||||
- `laneCapacity 3`, `energyCarryMax 1`, interleaved reveals, alternating initiative, `portalReveal [2,3,4]`
|
||||
- `underdog false`, no trend arrows
|
||||
|
||||
The derived cards are given directly (the §1 output), so the test needs no percentile table.
|
||||
Topics: **T1 Archive (depth, plain)**, **T2 Main Page (attention; Portal revealed turn 3; at scoring, each card here gets +1)**,
|
||||
**T3 Translations (reach, plain; revealed turn 4)**. Ana (p0) has initiative on odd turns and Bo (p1) on even turns.
|
||||
|
||||
| Player | Card | Faction | Cost | Base | Home | Keyword |
|
||||
|---|---|---|---|---|---|---|
|
||||
| Ana | Octopus | Nature | 1 | 2 | depth | – (vanilla) |
|
||||
| Ana | Moon | Space | 2 | 2 | reach | translated |
|
||||
| Ana | Coral reef | Nature | 2 | 2 | depth | rising |
|
||||
| Ana | Albert Einstein | People | 4 | 6 | attention | local |
|
||||
| Ana | Ancient Rome | History | 5 | 8 | depth | nostalgic |
|
||||
| Ana | Library of Alexandria | History | 4 | 6 | depth | nostalgic |
|
||||
| Ana | Periodic table | Science | 3 | 4 | depth | encyclopedic |
|
||||
| Bo | Haiku | Culture | 1 | 2 | attention | – (vanilla) |
|
||||
| Bo | Mars | Space | 2 | 2 | reach | translated |
|
||||
| Bo | Jazz | Culture | 2 | 2 | attention | viral |
|
||||
| Bo | Pop music | Culture | 4 | 6 | attention | viral |
|
||||
| Bo | Jupiter | Space | 5 | 8 | reach | translated |
|
||||
| Bo | Fern | Nature | 3 | 4 | depth | rising |
|
||||
| Bo | Mona Lisa | Culture | 3 | 4 | attention | viral |
|
||||
|
||||
Topic power is written as **Ana–Bo** after End of turn. Energy is "available / spent".
|
||||
|
||||
| Turn | Init | Energy Ana / Bo | Reveals, in interleaved order | T1 | T2 | T3 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| 1 | Ana | 1/1, 1/1 | Ana Octopus → T1: 2 +1 on-topic = **3**. Bo Haiku → T2: 2+1 = **3** | 3–0 | 0–3 | 0–0 |
|
||||
| 2 | Bo | 2/2, 2/0 | Bo passes (to carry 1). Ana Moon → T3: 2+1 = 3. translated: Octopus +1 → 4 | 4–0 | 0–3 | 3–0 |
|
||||
| 3 | Ana | 3/2, **4**/4 | Main Page Portal revealed. Ana Coral reef → T1: 2+1 = 3. Bo Mars → T3: 2+1 = 3, translated: Haiku +1 → 4. Bo Jazz → T2: 2+1 = 3, viral (Mars earlier) +1 → 4. End: rising Coral reef → 4 | 8–0 | 0–8 | 3–3 (tie; on-topic 1–1, so no leader) |
|
||||
| 4 | Bo | **5**/4, 4/4 | Bo Pop music → T3: 6 (off-topic), viral +0. Ana Einstein → T2: 6+2 on-topic, local +1 = **9**. End: rising Coral reef → 5 (cap reached) | 9–0 | 9–8 | 3–9 |
|
||||
| 5 | Ana | **6**/5, 5/5 | Ana Ancient Rome → T3: 8 (off-topic). nostalgic: losing 3–9, so +2 → **10**. Bo Jupiter → T1: 8 (off-topic). translated: Jazz → 5 (T2), Pop music → 7 (T3) | 9–8 | 9–9: **Bo leads** (consensus: on-topic 1 vs 2) | 13–10 |
|
||||
| 6 (last) | Bo | **7**/7, 6/6 | Bo Fern → T1: 4+2 = 6. Ana Library → T1: 6+2 = 8. nostalgic: losing 9–14, so +2 → **10**. Bo Mona Lisa → T2: 4+2 = 6, viral (Fern earlier) +1 → 7. Ana Periodic table → T2: 4 (off-topic), encyclopedic: no (cards here). End: rising Fern → 7. Scoring: Main Page +1 per card in T2 | **19–15** | **15–19** | **13–10** |
|
||||
|
||||
Final card values:
|
||||
- **T1:**
|
||||
- Ana: Octopus 4 + Coral reef 5 + Library 10 = 19.
|
||||
- Bo: Jupiter 8 + Fern 7 = 15.
|
||||
- **T2:** each card +1 from Main Page.
|
||||
- Ana: Einstein 10 + Periodic table 5 = 15.
|
||||
- Bo: Haiku 5 + Jazz 6 + Mona Lisa 8 = 19.
|
||||
- **T3:**
|
||||
- Ana: Moon 3 + Ancient Rome 10 = 13.
|
||||
- Bo: Mars 3 + Pop music 7 = 10.
|
||||
|
||||
**Ana wins 2–1.** Three moments show the v1 mechanics:
|
||||
- **Carry-over:** Bo passed on turn 2 to afford two plays on turn 3 (4 energy).
|
||||
- **Consensus:** T2 at 9–9 after turn 5 went to Bo, who had two on-topic attention cards to Ana's one.
|
||||
- **Interleaving decides the match:** on turn 6 Bo had initiative, so Fern revealed before Library. Ana was then losing T1 (9 vs 14) and nostalgic fired (+2).
|
||||
If Ana had revealed first, she'd have been ahead 9–8, nostalgic would not have fired, and T1 would have been 17–15. Ana still wins that lane, but by 2 instead of 4.
|
||||
|
||||
**Golden test for engine-b:**
|
||||
- **Inject:** the Topic order, the opening hands and the draw order directly, with each player's commit list per turn as in the table. The queue order within a turn is as listed.
|
||||
- **Expected final Topic powers:** `T1 19–15, T2 15–19, T3 13–10`. Winner: p0, by 2 Topics to 1.
|
||||
- **Also assert:**
|
||||
- after turn 5, T2 is a 9–9 tie with Bo leading by consensus
|
||||
- Ana's carried energy is 1 at the start of turns 4, 5 and 6
|
||||
- Bo's carried energy is 1 at the start of turn 3
|
||||
|
||||
### 12.1 The same match under the v1.1 ruleset
|
||||
Same cards, Topics, hands and commit lists; ruleset = §9 defaults (v1.1: `viral {base 1, cap 3}`, `encyclopedic {sides 1}`,
|
||||
`rising.powerDelta -1`, `cultureKeyword "home"`). The example's Culture cards (Jazz, Pop music, Mona Lisa) are attention-home, so they stay viral.
|
||||
Energy and carry are unchanged.
|
||||
|
||||
What changes:
|
||||
- **rising −1:** Coral reef is 1 base and ends at 1+1+2 = **4**; Fern is 3 base and ends at 3+2+1 = **6**.
|
||||
- **viral base 1:** Jazz +2 (Mars earlier), Pop music +1 (base only), Mona Lisa +2 (Fern earlier).
|
||||
- **nostalgic still fires** for Library (Ana is losing T1 8–13 just before it). **encyclopedic still doesn't** (Einstein is already on Ana's side of T2).
|
||||
|
||||
| After turn | T1 | T2 | T3 |
|
||||
|---|---|---|---|
|
||||
| 1 | 3–0 | 0–3 | 0–0 |
|
||||
| 2 | 4–0 | 0–3 | 3–0 |
|
||||
| 3 | 7–0 | 0–9 | 3–3 |
|
||||
| 4 | 8–0 | 9–9 | 3–10 |
|
||||
| 5 | 8–8: **Ana leads** (consensus: on-topic 2 vs 0) | 9–10 | 13–11 |
|
||||
| 6, before scoring | 18–14 | 13–18 | 13–11 |
|
||||
| **final** (Main Page +1 per card in T2) | **18–14** | **15–21** | **13–11** |
|
||||
|
||||
**Ana still wins 2–1.** The moments in v1.1:
|
||||
- **Carry-over:** unchanged.
|
||||
- **Consensus:** moves to **T1 after turn 5** (8–8). Ana has two on-topic depth cards there (Octopus, Coral reef) and Bo has only the off-topic Jupiter.
|
||||
- **Interleaving:** unchanged in kind. If Ana had revealed Library before Fern, T1 would have been 8–8 at that moment, a tie is not losing,
|
||||
so nostalgic would not fire and T1 would end 16–14.
|
||||
|
||||
**v1.1 golden test:** expected `lanePower [[18,14],[15,21],[13,11]]`, winner p0. Also assert the T1 8–8 consensus lead for p0 after turn 5.
|
||||
(Cross-checked by council-critic with the #27 engine, `tower-plus:scratchpad/critic/golden11.ts`, and by hand by designer-b.)
|
||||
@@ -47,8 +47,10 @@ const r = result(state); // { winner: 0 | 1 | null, reason, topicsLed, lanePow
|
||||
| `scoringPower(state, lane)` | Lane power plus revealed "at scoring" Portals (§7). `result().lanePower` uses this. |
|
||||
| `laneCapacity(state, lane)` | Per-seat capacity of a lane. A Portal such as Stub may override it. |
|
||||
| `isOnTopic(state, cardInPlay)` | §1.4/§6 on-topic test, including Disambiguation. |
|
||||
| `starterDeck(seed): GameCard[]` | A 12-card loaner deck (DESIGN §2). **Placeholder** cards until starter-cards.json lands. |
|
||||
| `previewPool(): GameCard[]` | Every loaner card once. For draft modes. |
|
||||
| `STARTER_DECKS`, `starterDeckById(id, rules?)` | The 4 DESIGN §2.1 starter decks (`stargazers`, `field-guide`, `headliners`, `pioneers`), derived through `deriveCard` with the given rules (a `Ruleset` works). **Use these for new players.** |
|
||||
| `starterDeck(seed)` | Older placeholder loaner deck (seeded, 2 per cost from `STARTER_POOL`). Kept for tests and tools; not a §2.1 starter deck. |
|
||||
| `previewPool(rules?)` | The 20 frozen `docs/game/starter-cards.json` loaners (council-data), derived via §1 against the `card-sample-2026-11-16` percentile table. For loaner slots and draft modes. |
|
||||
| `deriveCard(input, table, rules?)`, `deriveDeck(inputs, table, rules?)` | DESIGN §1 + §10.1: `CardInput` → `GameCard`. **Hosts only**: run on host-frozen, plausibility-checked inputs, never on client JSON. A `Ruleset` can be passed as `rules`. |
|
||||
| `placeCard(state, seat, lane, card)`, `revealPortal(state, lane)` | Test helpers for building boards by hand. |
|
||||
|
||||
## 2. Actions
|
||||
@@ -105,7 +107,14 @@ interface GameCard {
|
||||
|
||||
- **The engine takes already-derived cards and never reads raw stats.** The council asked for this, because snapshot stats are self-reported (#1, critic brief A.1).
|
||||
- Derivation (DESIGN §1 and §10.1: percentile → fame → cost → power, home, trend, keyword and vanillaBonus) lives in `shared/game/derive.ts`, which engine-b owns. Hosts run it on host-frozen, plausibility-checked inputs before calling `createMatch`.
|
||||
- `CardInput = { cardId, pageId | null, title, category, rarity, snapshot: { stats }, live: { trendPercent, dailyAverage }, check, pinned? }`. `pinned: { cost, home, faction }` replaces §1.1–1.5 **only** when `check === 'loaner'`. `check === 'unchecked'` caps cost at `uncheckedCostCap` (home and fame are kept).
|
||||
- **Never build `GameCard`s from client JSON.** `validateDeck` only checks shapes and ranges; a client could send cost 1 / power 30. Constructed modes must re-derive on the host.
|
||||
- Both seats can hold the same loaner `cardId`. The engine keys per seat, so UIs should key cards by `owner + cardId`.
|
||||
- Modes may adjust `GameCard` fields such as `power` before `createMatch`. The engine does not re-derive them.
|
||||
- **`check` and `pinned` are host decisions, not player input.** Build loaner inputs only from shipped data (`STARTER_DECKS`,
|
||||
`previewPool()`, `LOANER_SNAPSHOTS`), and set `check` for owned cards from the host's own §1.10 check. Otherwise a client could
|
||||
send `check: 'loaner', pinned: {cost: 1, …}` for any card.
|
||||
- **`obscure` leaks in v1.** `viewFor` does not mask Obscure cards yet. Modes must not put `obscure` in `keywordsEnabled` until it does.
|
||||
- A keyword that isn't in `ruleset.keywordsEnabled` never runs. Derivation is responsible for not giving that card `vanillaBonus`.
|
||||
- Lane power = `power` + `bonus` + `trend` + `onTopicBonus[cost]` if on-topic + ongoing keyword and Portal effects, floored at 0.
|
||||
|
||||
@@ -165,7 +174,7 @@ interface CardInPlay { card: GameCard; owner: 0 | 1; lane: number; turn: number;
|
||||
interface PlayerView {
|
||||
you: 0 | 1; ruleset; turn; phase; initiative;
|
||||
energy: number; energyLeft: number; hand: GameCard[]; queue: { cardId; lane }[]; committed; deckCount;
|
||||
opponent: { handCount; deckCount; queuedCount; committed }; // never their cards or queue
|
||||
opponent: { handCount; deckCount; committed }; // §5.3: nothing about their queue (cards, count or energy) until reveal
|
||||
lanes: { topic: TopicDef /* stat always; id/name/portal masked until portalRevealed */, portalRevealed, cards: [mine, theirs],
|
||||
cardPower: [number[], number[]], power: [mine, theirs], leader: 'you' | 'opponent' | null }[];
|
||||
result: MatchResult | null;
|
||||
@@ -191,7 +200,7 @@ Scoring runs after the last turn's End phase. Lane powers include revealed "at s
|
||||
|
||||
## 8. Keywords and Portals (extension contract)
|
||||
|
||||
`KEYWORDS` and `PORTALS` in `shared/game/keywords.ts` (engine-b) are registries of hook objects. The header of that file is normative. Every hook gets `ctx = { state, rng, params, lane, log, power(card) }`.
|
||||
`KEYWORDS` and `PORTALS` in `shared/game/keywords.ts` (engine-b) are registries of hook objects. v1 keywords (`V1_KEYWORDS`, one per faction via `FACTION_KEYWORD`): viral, rising, local, encyclopedic, nostalgic, translated; optional (`OPTIONAL_KEYWORDS`, off by default): edition, obscure, wildcard. Portals: the 6 kinds of §10.3. The header of that file is normative. Every hook gets `ctx = { state, rng, params, lane, log, power(card) }`.
|
||||
|
||||
**Keywords**
|
||||
- `onReveal(ctx, self)` and `endOfTurn(ctx, self)` may change `bonus` on cards in `ctx.state`.
|
||||
@@ -220,4 +229,4 @@ Portal hooks act only once the Portal is revealed.
|
||||
- on-topic power, the consensus tie-break, and Portal capacity, fizzle and at-scoring hooks
|
||||
- disabled keywords, AFK and concede, and draws
|
||||
- the random-play property: matches terminate, replay exactly, and serialise after every action
|
||||
- `tests/game-*.test.ts` (engine-b): keywords, card derivation, property tests and the DESIGN §12 golden match.
|
||||
- `tests/game-keywords`, `game-derive`, `game-starter`, `game-property`, `game-golden` (engine-b): every keyword and Portal, derivation, starter decks, properties (termination, determinism, round-trip, no input mutation, legality, power ≥ 0, capacity, no hand leak) and the DESIGN §12 golden match (19–15 / 15–19 / 13–10, p0 wins).
|
||||
|
||||
@@ -0,0 +1,272 @@
|
||||
# Hosting WikiDeck game modes
|
||||
|
||||
Anyone running a WikiDeck node can host their own **game modes**: their own twist on the
|
||||
rules, played with WikiDeck cards on their node, with visible credit for hosting them.
|
||||
Hosting a popular mode is the night-1 incentive to run a peer.
|
||||
|
||||
- Schema and validator: `shared/game/modes.ts`
|
||||
- Node API: `server/game/` (mounted at `/api/game` by `server/testnet/http.ts`)
|
||||
- Example modes: `server/game/modes/*.json` (shipped in the node image)
|
||||
- Tests: `tests/modes-*.test.ts`
|
||||
|
||||
Everything here is **off-chain**. Hosting a mode never touches blocks, transfers, trades,
|
||||
validation or NFT ownership. A match never moves or burns a card.
|
||||
|
||||
## 1. Modes are data, never code
|
||||
|
||||
A mode is a JSON document, at most 8 KiB:
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "wikideck.mode/1",
|
||||
"id": "trending",
|
||||
"version": 1,
|
||||
"name": "Trending",
|
||||
"description": "Live Wikipedia pageview trends power cards up or down.",
|
||||
"tags": ["live-data"],
|
||||
"rules": { "trendUp": 25, "trendDown": -25 },
|
||||
"cards": { "preset": "trending", "percentPerPoint": 25, "maxBonus": 3, "penalise": true },
|
||||
"decks": { "kind": "starter" },
|
||||
"limits": { "maxConcurrentMatches": 32, "turnSeconds": 90, "lobbyMinutes": 15 }
|
||||
}
|
||||
```
|
||||
|
||||
| Field | Meaning |
|
||||
|---|---|
|
||||
| `id`, `version` | Lowercase slug and a version integer. Bump `version` whenever the rules change, so old match records and leaderboards stay attributable (`<origin>#<id>@<version>`). |
|
||||
| `name`, `description`, `tags` | Plain text only: no control characters or `<` `>`. |
|
||||
| `rules` | **Overrides** on top of the engine's `DEFAULT_RULESET` (see `docs/game/ENGINE_API.md`). Objects merge one level deep; arrays and numbers replace. The merged result then goes through the engine's strict `parseRuleset`, so the engine alone decides what's legal (bounded turns, Topics, deck sizes, known keywords and portals only; see DESIGN.md §9 for the keys). |
|
||||
| `cards` | A card-mapping **preset** from a fixed list. `standard` leaves cards as dealt. `live` freezes each card's live trend arrow (DESIGN §1.6, using the ruleset's `trendUp`/`trendDown`) at match start. `trending` does the same and also adds a bounded power bonus from the live pageview trend. The mode only picks a preset and tunes its bounded numbers. |
|
||||
| `decks` | `starter` (everyone gets a seeded starter deck), `draft` (snake draft from a host-seeded pool of preview cards) or `constructed` (bring your own; see "Not yet" below). |
|
||||
| `limits` | Concurrency and lobby expiry for this mode on this host. `turnSeconds` only applies to engines without their own turn timer; with tonight's engine, the ruleset's `turnSeconds` (plus 5 s network grace) is the timer. |
|
||||
|
||||
The schema is strict: unknown fields are rejected, as are prototype keys
|
||||
(`__proto__`, `constructor`, `prototype`) anywhere in the document, nesting deeper than two
|
||||
levels inside `rules`, more than 48 rule keys, and oversized strings and arrays. A peer
|
||||
**never** evaluates, imports or runs anything another peer sends. Nothing in a mode can name
|
||||
a file, a URL, a script or a function.
|
||||
|
||||
## 2. Running your own modes
|
||||
|
||||
Configure modes with environment variables on your node:
|
||||
|
||||
| Variable | Default | Meaning |
|
||||
|---|---|---|
|
||||
| `WIKIDECK_MODES` | `classic` | Comma list of built-in ids (`classic`, `trending`, `draft`) and/or paths to `.json` files. `none` hosts nothing (the node still lists its peers' modes). |
|
||||
| `WIKIDECK_MODES_DIR` | unset | A directory: every `*.json` in it is loaded as a mode. |
|
||||
| `WIKIDECK_GAME_OPERATOR` | your origin's host | The name shown as **"Hosted by …"**. |
|
||||
| `WIKIDECK_GAME_NOTE` | unset | A short note shown next to your name, e.g. "EU, best effort". |
|
||||
| `WIKIDECK_GAME_PEERS` | `WIKIDECK_PEERS` | Peer origins whose modes to list. Use the peers' **public** origins, because players open the peer's own site to play there. |
|
||||
| `WIKIDECK_GAME_TREND_INTERVAL_MS` | `20000` | Background trend warm-up pace for `trending` modes (minimum 15000). |
|
||||
| `PUBLIC_ORIGIN` | `http://127.0.0.1:$PORT` | Your node's identity as a host. |
|
||||
|
||||
At most 16 modes per node. A bad mode file stops the node at startup with a readable error,
|
||||
because rules are validated once with the engine's parser when the node starts.
|
||||
|
||||
Example for the night-1 testnet (three nodes, different modes):
|
||||
|
||||
```yaml
|
||||
# node-a: the base rules plus Trending
|
||||
WIKIDECK_MODES: classic,trending
|
||||
WIKIDECK_GAME_OPERATOR: Testnet A
|
||||
WIKIDECK_GAME_PEERS: http://192.168.1.32:3102,http://192.168.1.32:3103
|
||||
# node-b: the draft
|
||||
WIKIDECK_MODES: draft
|
||||
WIKIDECK_GAME_OPERATOR: Testnet B
|
||||
# node-c: everything, including a custom file
|
||||
WIKIDECK_MODES: classic,trending,draft,/app/data/modes/blitz.json
|
||||
```
|
||||
|
||||
### Writing a new mode
|
||||
|
||||
Start from `server/game/modes/classic.json`, change `id`, `name` and `description`, then
|
||||
override rules. Some ideas within tonight's rules:
|
||||
|
||||
- **Blitz:** `"rules": { "turns": 4, "energyByTurn": [3, 4, 5, 6] }`
|
||||
- **On-topic:** `"rules": { "onTopicBonus": [0, 2, 2, 3, 3, 4, 4], "trendUp": 10, "trendDown": -10 }`
|
||||
- **Slow play:** `"rules": { "turns": 6, "turnSeconds": 40 }` (the engine caps turns × turnSeconds at 240)
|
||||
- **Big decks:** `"rules": { "deckSize": 16, "maxLoaners": 16 }` with `"decks": { "kind": "draft", "poolSize": 40 }`.
|
||||
Starter decks are 12 cards, so a non-draft mode with another deck size is rejected at startup.
|
||||
|
||||
Check that a mode parses with `npm test` (the built-in modes are tested), or load it on a
|
||||
local node: it fails at startup if the engine rejects it.
|
||||
|
||||
## 3. The node API
|
||||
|
||||
Everything is under `/api/game`, behind the node's existing `/api` admission budget and
|
||||
global rate limit, plus stricter per-route limits.
|
||||
|
||||
| Method | Path | What it does |
|
||||
|---|---|---|
|
||||
| GET | `/modes` | **Publish:** this node's host identity, total matches hosted, and each mode with live stats (players online, open lobbies, live matches, matches played, distinct players). |
|
||||
| GET | `/network/modes` | **Discover:** this node's list plus each configured peer's list, fetched as data. |
|
||||
| GET | `/hosts/leaderboard` | Hosts ranked by matches hosted (this node plus peers). |
|
||||
| GET | `/modes/:id/leaderboard` | Per-mode player leaderboard (wins, losses, draws). |
|
||||
| GET | `/modes/:id/lobbies` | Open lobbies waiting for an opponent. |
|
||||
| POST | `/modes/:id/lobbies` | Create a lobby: `{ name, secret }` → `{ lobbyId, seat: 0, token }`. |
|
||||
| POST | `/lobbies/:lobby/join` | Join: `{ name, secret }` → `{ lobbyId, seat: 1, token }`. The match (or draft) starts. |
|
||||
| GET | `/lobbies/:lobby` | Status. With `Authorization: Bearer <token>`: your `PlayerView` and your `legalActions`. |
|
||||
| POST | `/lobbies/:lobby/pick` | Draft pick: `{ index }`. |
|
||||
| POST | `/lobbies/:lobby/actions` | Play: `{ action }`, which must equal one of your `legalActions`. |
|
||||
| POST | `/lobbies/:lobby/resign` | Resign (or cancel a waiting lobby). |
|
||||
| GET | `/matches/:matchId` | A finished match record: seed, both decks, the full action log and the result. |
|
||||
|
||||
**Players.** The browser generates a random `secret` once and keeps it in local storage. The
|
||||
host only ever stores and shows `sha256("wikideck-player:" + secret)` as the player id, so a
|
||||
leaderboard name can't be claimed by someone else who uses the same display name. Each seat
|
||||
also gets a fresh bearer token per lobby; only its hash is kept. When eom.dev accounts land
|
||||
(#7), the player id can come from the account instead.
|
||||
|
||||
**Playing on a peer's mode.** The browser's CSP keeps API calls same-origin, so the lobby
|
||||
shows peer modes with "Hosted by …" and links to the peer's own site to play there. No node
|
||||
proxies another node's matches.
|
||||
|
||||
### Restarts
|
||||
|
||||
Live lobbies, drafts and matches survive a node restart. The node saves them to
|
||||
`$WIKIDECK_DATA_DIR/game/live.json` every 15 s and on SIGTERM/SIGINT, and restores them on start.
|
||||
Player tokens keep working, and turn and draft timers restart from the moment the node is back.
|
||||
A lobby is dropped instead of restored if its mode is no longer hosted with the same `version`
|
||||
and rules, so a match never continues under different rules. A hard crash can lose up to 15 s
|
||||
of moves.
|
||||
|
||||
## 4. Credit for hosts
|
||||
|
||||
Every mode shows **"Hosted by <operator>"** (with the node's origin), its player counts,
|
||||
its own leaderboard, and the node's total matches hosted. `/hosts/leaderboard` ranks nodes by
|
||||
matches hosted.
|
||||
|
||||
Tonight these numbers are **informational**: each node reports its own counts. See section 6
|
||||
for how they could become rewards without trusting the host's word.
|
||||
|
||||
## 5. Security notes
|
||||
|
||||
### Limits
|
||||
|
||||
| Limit | Value |
|
||||
|---|---|
|
||||
| Mode document | 8 KiB; 48 rule keys; rule nesting depth 2; strings ≤ 64 chars inside rules |
|
||||
| Modes per node / per peer response | 16 |
|
||||
| Peer `/api/game/modes` response | 192 KiB, read with a streaming byte cap; 3 s timeout; no redirects; cached 30 s; at most one refresh in flight |
|
||||
| Peers | at most 16, operator-configured origins only (HTTPS, or HTTP with `WIKIDECK_ALLOW_PRIVATE_PEERS=1`) |
|
||||
| Lobbies + matches in memory | 512 per node; `maxConcurrentMatches` per mode; 3 per player |
|
||||
| Match length | engine bounds (`turns` ≤ 12, turns × turnSeconds ≤ 240 s) plus a hard 2,000-action cap |
|
||||
| Rate limits per IP | 240/min reads and plays, 60/min lobby create/join/resign, 30/min peer-discovery routes (on top of the node-wide 300/min `/api` limit and the RPC admission budget) |
|
||||
| Request body | the node's 68 KB JSON limit |
|
||||
| Wikipedia lookups (`trending`) | background only: one page per 20 s by default (`WIKIDECK_GAME_TREND_INTERVAL_MS`, minimum 15 s), at most 256 queued, never per request |
|
||||
|
||||
### Mode validation
|
||||
|
||||
A mode is rejected at node startup, never handed to the engine half-checked, if:
|
||||
- it fails the mode schema (section 1), or
|
||||
- the merged ruleset fails the engine's strict `parseRuleset`, or
|
||||
- it fails the host-side checks in `server/game/engine-binding.ts`: `distinctStats` requires
|
||||
`topicCount` 3; every `portalReveal` turn ≤ `turns`; `energyByTurn` has an entry per turn;
|
||||
`turns × turnSeconds ≤ 240`; `powerByCost` has 7 entries; no keyword whose hidden information
|
||||
`viewFor` doesn't mask yet (`obscure`) is enabled; or
|
||||
- its deck policy can't produce legal decks (starter decks illegal under its rules, or a draft
|
||||
pool smaller than 2 × `deckSize`).
|
||||
|
||||
### Wikipedia load (`verifyStats`)
|
||||
|
||||
Our Wikipedia egress is shared and rate-limited, so tonight the host makes **no Wikipedia
|
||||
requests in any request or match path**:
|
||||
- Hosted decks are loaners (starter or drafted), so there are no owned-card stats to verify,
|
||||
and `verifyStats` never triggers a fetch.
|
||||
- When owned decks arrive, verification must use the DESIGN §1.10 immutable cache keyed by
|
||||
`(pageId, revisionId, snapshotMonth)`, with `check: 'unchecked'` and `uncheckedCostCap` as the
|
||||
normal path when the cache is cold, not a per-card fetch.
|
||||
- `trending` reads only the background-warmed trend cache (see "Not yet").
|
||||
|
||||
### Cheating
|
||||
|
||||
- **The client is never trusted.** Each action must deep-equal one of the engine's
|
||||
`legalActions` for the token's seat, so you can't act for the other seat, play cards you
|
||||
don't hold, overspend energy or act after the match ends.
|
||||
- **Hidden information stays on the host.** Each seat only ever receives `viewFor(state, seat)`;
|
||||
the opponent's hand and staged plays never leave the server. Spectators see status only.
|
||||
- **Seeds are the host's.** The host picks a random seed when the lobby opens, so players can't
|
||||
grind for a favourable shuffle. The engine hashes it to 32 bits: fine against players, but
|
||||
not a secret worth relying on against a host.
|
||||
- **Stalling:** when a seat runs out of turn time, the host applies the engine's `timeout`
|
||||
action (auto-commit). After `afkTurns` idle timeouts the engine forfeits that seat. Timeouts
|
||||
are in the action log, so they replay. A stalled draft pick is made automatically.
|
||||
- **Sybils and win-trading:** anyone can make a new player id, and two ids controlled by the same
|
||||
person can feed each other wins. Tonight's leaderboards are for fun. Accounts (#7) or
|
||||
wallet-signed identities would raise the cost.
|
||||
- **Card input.** The host builds every deck from shipped engine data (starter decks and the
|
||||
loaner pool). It never accepts cards, `check` values or pinned stats from client JSON.
|
||||
- **Card stats.** Card numbers come from the engine's card mapping. Minted stats are self-reported
|
||||
by the minter (see council-critic in #3); a mode can only pick a mapping preset, not supply numbers.
|
||||
|
||||
### What a malicious host can and can't do
|
||||
|
||||
**Hosted PvP trusts the host.** The host holds both players' hidden plans (hands and queued plays)
|
||||
and relays them; it decides the seed; and it would be the one to mark card stats as checked or
|
||||
unchecked (DESIGN §1.10). Nothing tonight lets players verify a match *while* it's being played.
|
||||
So a host is **trusted for the matches it hosts**, and only those. Play on hosts you trust, and
|
||||
treat leaderboards on any other host as that host's claims.
|
||||
|
||||
A malicious host **can**:
|
||||
- lie about its stats, its matches hosted and its leaderboards;
|
||||
- rig its own matches: pick seeds, peek at hands, or ignore the rules;
|
||||
- drop or stall your match, or record a false result.
|
||||
|
||||
A malicious host **can't**:
|
||||
- touch your cards: matches are off-chain, and the host never receives a key or signature;
|
||||
- run code on other nodes: its modes are inert data, validated with hard limits;
|
||||
- make other nodes fetch anything except its own `/api/game/modes`, or make them fetch it
|
||||
in a way that slows them down (byte cap, timeout, cache, single flight);
|
||||
- publish modes under another node's origin: discovery pins the origin it actually fetched;
|
||||
- see your player secret: it only receives it once, over its own origin, and stores the hash.
|
||||
**Use a different secret per host** if you don't trust a host (the UI can derive one per origin).
|
||||
|
||||
**Audit trail.** Every finished match record publishes the seed, both decks and the full action
|
||||
log, so anyone can re-run it with the engine's `replay(ruleset, decks, seed, actions)` and check
|
||||
the result. A host that lies about a result can be caught; a host that peeked at hands can't.
|
||||
|
||||
## 6. Proposal: on-chain host rewards (not tonight)
|
||||
|
||||
Rewarding hosts on-chain is a **protocol change**, so it's out of scope for night 1. This is a
|
||||
proposal for later, to be reviewed like any consensus change.
|
||||
|
||||
**Goal:** pay hosts for matches real players actually played, without trusting the host's count.
|
||||
|
||||
1. **Signed match results.** Both players sign the final result
|
||||
(`matchId`, `<origin>#<id>@<version>`, seed hash, action-log hash, winner) with their wallet
|
||||
keys. The host signs too. A result needs all three signatures, so a host can't invent matches
|
||||
or results alone, and players can't deny a match they played.
|
||||
2. **Replayable evidence.** The record keeps the seed, decks and action log. Anyone can replay it
|
||||
with the pinned engine version to check the result. Disputes are settled by replay, not by vote.
|
||||
3. **Batched claims.** Once per epoch, a host submits one transaction committing a Merkle root of
|
||||
its signed results. A new `hostClaim` transaction type would carry the root and a count. This is
|
||||
the protocol change: a new transaction type, its validation and its reward rule.
|
||||
4. **Rewards that resist farming.** A host's reward per epoch grows with the number of **distinct
|
||||
paired wallets** (not matches), each wallet counts toward at most one host per epoch, wallets
|
||||
must hold at least one minted card older than N blocks, and the total is a small, capped
|
||||
share of block rewards. That makes sybil farms cost real mining work.
|
||||
5. **Challenges.** For a window after a claim, anyone can post a replay that contradicts a
|
||||
committed result, or proof that a wallet was double-counted. A successful challenge voids
|
||||
the host's claim for that epoch.
|
||||
|
||||
Open questions: who pays (a share of block rewards versus a fee from players), how to stop
|
||||
colluding players and hosts from farming one another, and whether the engine version must
|
||||
be pinned in consensus.
|
||||
|
||||
## Not yet
|
||||
|
||||
- `constructed` decks of **owned NFTs**: the policy exists, but tonight the host deals
|
||||
starter decks for it. Playing with your own cards needs a wallet-signed ownership proof
|
||||
for the lobby (and then the engine's `cardFromStats`). That's a follow-up once accounts and
|
||||
wallet linking (#7) settle.
|
||||
- `trending` never calls Wikipedia when a match starts. The node warms a cache-only trend
|
||||
store in the background, one page every 20 s (configurable, never faster than 15 s), through its existing enrichment cache (6 h TTL),
|
||||
starting with the preview-card pages. A card whose page isn't warm yet gets no bonus. This
|
||||
keeps load on the shared, rate-limited Wikipedia egress tiny: a few dozen pages per 6 hours per node.
|
||||
- Spectating and rematches.
|
||||
- **Separate game RPC budget.** `/api/game` sits behind the node's global `/api` admission
|
||||
budget (`WIKIDECK_RPC_REQUESTS_PER_SECOND`, 10 writes/s node-wide), so a flood of game
|
||||
traffic can delay chain RPC (and the reverse). At human speed this is fine. The fix is to give
|
||||
game routes their own `RpcBudget`, which means mounting them ahead of the shared budget in
|
||||
`server/testnet/http.ts`: a change to that shared file, so it's proposed in #6 rather than made
|
||||
tonight.
|
||||
@@ -0,0 +1,40 @@
|
||||
# WikiDeck Android app (Night 1)
|
||||
|
||||
A Capacitor 7 shell (`dev.eom.wikideck`) around the React UI. It talks to a WikiDeck node over native HTTP.
|
||||
|
||||

|
||||
|
||||
## Build a debug APK
|
||||
You need JDK 21 (a full JDK with `javac`), the Android SDK (platform 35 and build-tools 35) and `ANDROID_HOME`.
|
||||
```
|
||||
android/build-debug.sh # testnet build: VITE_WIKIDECK_NETWORK=testnet, genesis 1792411200, node http://192.168.1.32:3101
|
||||
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
|
||||
```
|
||||
- **Settings:** override any of them with env vars, for example `VITE_NODE_URL=http://192.168.1.32:3102 android/build-debug.sh`.
|
||||
- **Network:** without `VITE_WIKIDECK_NETWORK=testnet`, the bundle is a **mainnet** build.
|
||||
- **Signing:** debug signing only. Nothing is published.
|
||||
|
||||
## How it works (`src/native.ts`, imported first in `main.tsx`; does nothing on the web)
|
||||
- **Node URL:** relative `fetch('/api/…')` and `fetch('/auth/…')` calls go to `VITE_NODE_URL`. The default is the Night-1 testnet node. A runtime override is available through `setNodeUrl()`, stored in localStorage.
|
||||
- **Native HTTP (`CapacitorHttp`):** fetches go through Android's HTTP stack. There's no CORS, and no WebView `Origin` header, so the node's POST origin check passes without any server change.
|
||||
- Verified: a POST from the app returns 400 (validation), while the same POST with `Origin: https://localhost` returns 403.
|
||||
- The interceptor merges headers (`content-length: 0, 384`). `native.ts` drops that header so `StateClient`'s size check works, and byte limits are still enforced while streaming.
|
||||
- **Mining:** RandomX is desktop-only. `isNativeApp()` hides the mining panel, and `html.native-app` lets CSS target the app.
|
||||
- **SSO:** "Log in with eom.dev" opens Dex in a Custom Tab (`setNativeBrowser(Browser)`). Dex redirects to `dev.eom.wikideck:/oauth/callback` (intent filter, `singleTask`), and `completeLogin()` has the node exchange the code.
|
||||
- **Android behaviour:**
|
||||
- The **back button** closes an open dialog first, then goes back in history, then minimizes the app.
|
||||
- The **keyboard** uses `adjustResize`.
|
||||
- **Edge-to-edge** margins are on, with a dark window behind the system bars.
|
||||
|
||||
## Emulator (inspiron-3670, user space)
|
||||
The SDK, AVD and JDK are under `~/worker/jobs/night/mobile-android/{sdk,avd,jdk}`, and `env.sh` sets the paths.
|
||||
```
|
||||
emulator -avd wikideck -no-window -no-audio -gpu swiftshader_indirect # headless, KVM
|
||||
adb exec-out screencap -p > shot.png
|
||||
```
|
||||
To inspect the WebView, forward DevTools with `adb forward tcp:9222 localabstract:webview_devtools_remote_$(adb shell pidof dev.eom.wikideck)`.
|
||||
|
||||
## Known gaps
|
||||
- **Real SSO login:** needs an eom.dev account and wasn't done tonight. The deep-link round trip was verified up to Dex's `invalid_grant` for a dummy code.
|
||||
- **Touch targets in the Play UI:** the dashed "Play here" lane zone doesn't respond to taps; only the lane plate does (reported on #5).
|
||||
- **Mining copy on the home hero:** "Explore mining" still shows in the app.
|
||||
@@ -0,0 +1,53 @@
|
||||
# Night 1: module boundaries
|
||||
|
||||
Owner: `night-lead`. This file is the rule when two PRs touch the same path. If you need to edit a path you don't own, comment on the owner's issue (`[from <you>]`) or keep your change to the "shared hook" listed below.
|
||||
|
||||
## Who owns what
|
||||
|
||||
| Path | Owner | Issue |
|
||||
|---|---|---|
|
||||
| `docs/game/DESIGN.md` | council (designer-a, designer-b, critic) | #1 |
|
||||
| `docs/game/CARD_DATA.md`, `docs/game/card-sample.json` | council-data | #2 |
|
||||
| `shared/game/` (types, RNG, state machine, rules, keywords, `Ruleset`, `starterDeck`) | engine-a (core, API), engine-b (keywords, effects) | #3 |
|
||||
| `docs/game/ENGINE_API.md` | engine-a | #3 |
|
||||
| `shared/game/modes.ts` | modes | #6 |
|
||||
| `server/game*` (e.g. `server/game/`, `server/game-*.ts`) | modes | #6 |
|
||||
| `docs/game/HOSTING.md` | modes | #6 |
|
||||
| `src/game/` (screens, lobby, deck builder, match, tutorial) | ui-a | #5 |
|
||||
| `src/game/ai/` (browser bots, easy and normal) | ui-b | #5 |
|
||||
| beta-fix files outside `src/game/` (landing page, `Card.tsx`, etc.) | ui-b, one PR per upstream issue | #5 |
|
||||
| `shared/bots/`, `scripts/sim/` (bots and the simulation runner) | sim-balance | #4 |
|
||||
| `docs/game/BALANCE.md` | sim-balance | #4 |
|
||||
| `compose.testnet.yaml` overrides, `deploy/night/` (testnet config, per-node mode files) | sim-testnet | #4 |
|
||||
| `server/account*` (e.g. `server/account/`), `src/auth/` | sso | #7 |
|
||||
| `android/`, `capacitor.config.ts` | mobile-android | #8 |
|
||||
| `ios/`, `docs/night/IOS.md` | mobile-ios, macos-fetch | #9 |
|
||||
| `docs/night/` (except `IOS.md`), this file, `REPORT.md` | night-lead | #10 |
|
||||
|
||||
## Tests
|
||||
|
||||
`scripts/run-tests.mjs` only picks up **top-level** `tests/*.test.ts`. Name your files with your team as a prefix so they never collide:
|
||||
`tests/game-*.test.ts` (engine), `tests/modes-*.test.ts`, `tests/ui-*.test.ts`, `tests/bots-*.test.ts`, `tests/account-*.test.ts`.
|
||||
|
||||
## Shared hooks (the only places two teams touch the same file)
|
||||
|
||||
1. **`server/testnet/http.ts`**: modes and sso each export an Express `Router` from their own files and add **exactly one** `app.use(...)` mount line just **above** the `/api` 404 handler (`app.use(['/api','/p2p'],(_req,res)=>{res.status(404)...`). Nothing else in this file. If SSO needs a CSP change (`connect-src` for `https://dex.eom.dev`), keep it to the `helmet` directive and say so in the PR.
|
||||
2. **`src/App.tsx`**: ui-a owns it. Others get one import and one element each (sso: a login button or provider; mobile: hide the mining controls behind a `isNativeApp()` check from `src/game/` or `src/auth/`, never by deleting code).
|
||||
3. **`package.json` and `package-lock.json`**: additive changes only (new dependencies or scripts). Don't reformat or bump existing versions. Lockfile conflicts are resolved by night-lead regenerating the lockfile.
|
||||
4. **`shared/enrichment.ts`**: read-only for everyone tonight. Map card data into game stats inside `shared/game/`.
|
||||
|
||||
## Off limits (consensus and protocol; PRs touching these are rejected)
|
||||
|
||||
`server/chain.ts`, `shared/protocol.ts`, `shared/trade-offer.ts`, `shared/chain-identity.ts`, `shared/network.ts`, `server/testnet/consensus.ts`, `server/testnet/ledger.ts`, `server/testnet/canonical-index.ts`, `server/testnet/randomx.ts`, `server/testnet/miner.ts`, `server/testnet/peers.ts`, `native/`.
|
||||
|
||||
If you think you need a change there, write it up in your issue instead.
|
||||
|
||||
## Dependency direction
|
||||
|
||||
`shared/game/` imports nothing from `server/` or `src/` and does no I/O. `shared/game/modes.ts`, `shared/bots/`, `server/game*`, `src/game/` import from `shared/game/` through the API in `ENGINE_API.md`, not from its internals.
|
||||
|
||||
## Merging
|
||||
|
||||
- Branch `night/<team>/<topic>`, PR into `night/2026-11-16`, squash-merged by night-lead after night-review approves and `npm test` and `npm run build` pass.
|
||||
- Small PRs merge faster. Rebase on the integration branch before asking for review if it moved under you.
|
||||
- After 01:10 (code freeze), only fixes merge.
|
||||
@@ -56,6 +56,7 @@ Turn WikiDeck into a game:
|
||||
flock /tmp/night-heavy.lock <npm ci | npm run build | gradle ...>
|
||||
```
|
||||
- **imac** (8 threads, about 4 GB free) and **poweredge-r350** (16 threads, about 6 GB free): keep builds to one at a time.
|
||||
- **Avoid permission prompts.** Nobody answers them, and they auto-deny after about a minute. Don't chain `cd <dir> && <command that writes files>`; use absolute paths or `git -C <dir>` instead. Keep each shell command to one clear purpose.
|
||||
- **LocalAI** (`https://localai.eom.dev`) is shared production with slow single-GPU inference. Don't use it in loops.
|
||||
|
||||
## Timeline (EST)
|
||||
|
||||
@@ -0,0 +1,92 @@
|
||||
# iOS app and macOS VM (Night 1, mobile-ios, issue #9)
|
||||
|
||||
## Status at a glance
|
||||
- **macOS VM:** QEMU/KVM on inspiron-3670, OSX-KVM style. Sequoia (15) recovery booted, disk erased (APFS volume `machd`),
|
||||
licence accepted, and **"Reinstall macOS Sequoia" was downloading the full OS from Apple** over inspiron's Wi-Fi
|
||||
(installer estimate ~2 h 50 min from 23:33). Per the coordinator, the VM is **shut down cleanly before 01:30**
|
||||
with the disk kept. See "Progress at shutdown" below for exactly where it got to.
|
||||
- **No Apple ID** was created or used. Nothing signed in to Apple.
|
||||
- **iOS Capacitor project:** `ios/` (Capacitor **7.6.x**, Swift Package Manager, no CocoaPods), app id
|
||||
`dev.eom.wikideck`, URL scheme `dev.eom.wikideck` registered for the SSO redirect.
|
||||
- **Build script:** `scripts/ios/build-sim.sh` (run inside the VM once Xcode is installed). Not yet run: needs Xcode.
|
||||
|
||||
## Where things are (inspiron-3670, outside git)
|
||||
| Path | What |
|
||||
|---|---|
|
||||
| `~/worker/jobs/macos/boot-macos.sh` | Starts the VM: 8 GB RAM, 4 vCPU, q35, OpenCore, VNC 127.0.0.1:5911, SSH fwd 127.0.0.1:10022 |
|
||||
| `~/worker/jobs/macos/mac_hdd_ng.qcow2` | 80 GB macOS system disk (keep this) |
|
||||
| `~/worker/jobs/macos/BaseSystem.img` | Sequoia recovery (3,221,110,784 bytes), converted from macos-fetch's verified `BaseSystem.dmg` |
|
||||
| `~/worker/jobs/macos/OpenCore-osxkvm.qcow2` | OpenCore bootloader from kholia/OSX-KVM |
|
||||
| `~/worker/jobs/macos/OVMF_CODE_4M.fd`, `OVMF_VARS.fd` | UEFI firmware and this VM's NVRAM |
|
||||
| `~/worker/jobs/macos/vnc.sh` | `vncdotool` wrapper (`./vnc.sh capture x.png`, `./vnc.sh type ...`) |
|
||||
| `~/worker/jobs/macos/guest/provision.sh` | Runs **inside** macOS: Command Line Tools + Node 24 (no Apple ID) |
|
||||
| `~/worker/jobs/macos/CREDENTIALS.txt` | Local macOS user + password (mode 600, never in git), once the account exists |
|
||||
|
||||
## Start the VM again (resume)
|
||||
On inspiron-3670:
|
||||
```
|
||||
cd ~/worker/jobs/macos
|
||||
setsid ./boot-macos.sh > qemu.log 2>&1 < /dev/null & # installer image still attached
|
||||
# after macOS is fully installed you can detach it: NO_INSTALLER=1 setsid ./boot-macos.sh ...
|
||||
```
|
||||
- In the OpenCore picker pick **`macOS Installer`** / **`machd`** (whichever is offered after the interrupted install;
|
||||
if only "macOS Base System" shows, the download restarts: pick it → **Reinstall macOS Sequoia** → disk `machd`).
|
||||
- Clean shutdown from outside: `echo system_powerdown | socat - UNIX-CONNECT:$HOME/worker/jobs/macos/qemu-monitor.sock`
|
||||
(or `kill $(cat ~/worker/jobs/macos/qemu.pid)` if the guest is hung).
|
||||
|
||||
### See it (VNC through an SSH tunnel from tower-plus)
|
||||
```
|
||||
ssh -N -L 5911:127.0.0.1:5911 eric@inspiron-3670 # on tower-plus
|
||||
# then open a VNC viewer on tower-plus at localhost:5911 (no VNC password; it is bound to localhost only)
|
||||
```
|
||||
SSH into macOS (after Remote Login is on): `ssh -p 10022 <user>@127.0.0.1` on inspiron, or tunnel `-L 10022:127.0.0.1:10022`.
|
||||
|
||||
Note: the VNC keyboard via `vncdotool` drops Shift (everything types lowercase, `|` becomes `\`). A normal VNC viewer is fine.
|
||||
|
||||
## Eric's checklist from here (~10 min of attention, plus download time)
|
||||
1. **Finish the install:** start the VM (above), open VNC, let the installer finish (several reboots, pick `machd` /
|
||||
`macOS Installer` in OpenCore each time if it doesn't auto-boot).
|
||||
2. **Setup Assistant:** country, *skip* Apple ID ("Set Up Later"), create a local admin user. Put the user and password in
|
||||
`~/worker/jobs/macos/CREDENTIALS.txt` (`chmod 600`).
|
||||
3. **Enable SSH:** System Settings → General → Sharing → Remote Login: on.
|
||||
4. **Prerequisites (no Apple ID):** copy and run the guest script:
|
||||
```
|
||||
scp -P 10022 ~/worker/jobs/macos/guest/provision.sh <user>@127.0.0.1:
|
||||
ssh -p 10022 <user>@127.0.0.1 ./provision.sh
|
||||
```
|
||||
5. **Sign in with your Apple ID and install Xcode** (App Store, or developer.apple.com/download). Launch it once,
|
||||
accept the licence, install the **iOS platform + a Simulator runtime** when prompted.
|
||||
6. **Build and run:**
|
||||
```
|
||||
ssh -p 10022 <user>@127.0.0.1
|
||||
git clone -b night/2026-11-16 https://gitea.eom.dev/claude/wikideck.git && cd wikideck
|
||||
scripts/ios/build-sim.sh # optional arg: simulator name, default "iPhone 16"
|
||||
```
|
||||
It runs `npm ci`, `npm run build`, `npx cap sync ios`, `xcodebuild` for the simulator (no signing), installs and
|
||||
launches `dev.eom.wikideck`, and saves a screenshot to `~/wikideck-ios-sim.png`.
|
||||
|
||||
## App notes
|
||||
- Scaffold (`capacitor.config.ts`, Capacitor deps in `package.json`) is owned by mobile-android (#8); `ios/` builds on it.
|
||||
Capacitor **7** to match Android (Node 20 on inspiron).
|
||||
- **Swift Package Manager**, not CocoaPods: `ios/App/CapApp-SPM/Package.swift` is managed by `npx cap sync`; Xcode
|
||||
resolves `capacitor-swift-pm` itself. No Ruby/CocoaPods needed in the VM.
|
||||
- **Testnet build:** `build-sim.sh` sets the same defaults as `android/build-debug.sh`: `VITE_WIKIDECK_NETWORK=testnet`,
|
||||
`VITE_WIKIDECK_GENESIS_TIME=1792411200`, `VITE_NODE_URL=http://192.168.1.32:3101` (override via env).
|
||||
- **Plain HTTP to the LAN node:** `Info.plist` sets `NSAppTransportSecurity` → `NSAllowsLocalNetworking` (local/IP hosts
|
||||
only, not arbitrary HTTP), because iOS ATS blocks cleartext by default. From the VM's simulator, 192.168.1.32 is reached
|
||||
through QEMU's user-mode NAT on inspiron.
|
||||
- **Plugins:** `@capacitor/app` and `@capacitor/browser` (from #35) are wired into `CapApp-SPM/Package.swift`.
|
||||
- **Origin check:** mobile-android routes native requests through `CapacitorHttp`, which sends no `Origin` header, so
|
||||
`server/testnet/http.ts` needs no change. Without it, the iOS WebView origin would be `capacitor://localhost`.
|
||||
- **SSO (#7):** `Info.plist` registers the `dev.eom.wikideck` URL scheme; redirect `dev.eom.wikideck:/oauth/callback`
|
||||
returns to the app via `@capacitor/app`'s `appUrlOpen`.
|
||||
|
||||
## Progress at shutdown
|
||||
_(filled in before 01:25)_
|
||||
|
||||
## What's verified
|
||||
- `BaseSystem.dmg` sha256 matches macos-fetch's `SHA256SUMS`; converted `BaseSystem.img` is 3,221,110,784 bytes.
|
||||
- VM boots on inspiron (KVM, no host `ignore_msrs` change needed): OpenCore → Sequoia recovery → Terminal, Disk Utility.
|
||||
- Disk erase (APFS) and the installer download started.
|
||||
- `npx cap add ios --packagemanager SPM` (Capacitor 7.6.10) generates the project on Linux; bundle id `dev.eom.wikideck`.
|
||||
- **Not verified:** the macOS install finishing, Xcode, `build-sim.sh`, the app in the Simulator.
|
||||
@@ -0,0 +1,75 @@
|
||||
# WikiDeck Night 1: report
|
||||
|
||||
**Night:** 2026-11-16 22:45 → 2026-11-17 01:30 EST. 17 Claude agents on 4 machines, coordinated through Gitea (milestone 63, issues #1–#10).
|
||||
**Branch:** `claude/wikideck:night/2026-11-16`. Everything below came in through 38 PRs that night-review reviewed and night-lead squash-merged.
|
||||
**Untouched:** the live deployment, mainnet, and every consensus and protocol file. The off-limits list is in `docs/night/BOUNDARIES.md`.
|
||||
|
||||
## What works
|
||||
|
||||
| Area | Status | Where |
|
||||
|---|---|---|
|
||||
| **The game, "Edit War"** | Playable in the browser against an AI: a lobby, a deck builder with 4 loaner starter decks, matches, results and a tutorial. Works on a 360 px phone. | `src/game/`, PR #26 #30 (landing page, upstream WikiDeck/wikideck#3), #31 (easy and normal browser bots), #45 |
|
||||
| **Rules engine** | Pure, deterministic TypeScript with the rules as data. `createMatch`, `legalActions`, `applyAction`, `viewFor` and serialisation. 6 keywords and 6 Portals. Property tests, plus a §12 golden match checked by hand. | `shared/game/`, `docs/game/ENGINE_API.md`, #25 #27 #29 #33 #36 (v1.1 as the default), #38 (planning is hidden) |
|
||||
| **Design** | DESIGN.md v1 (frozen 23:01), then v1.1 tuned from the balance report. | `docs/game/DESIGN.md`, #13 #17 #23 #24 #32 |
|
||||
| **Card data** | 236 sampled articles, with real distributions, percentile tables and 48 starter pageIds. | `docs/game/CARD_DATA.md`, `card-sample.json`, #20 #28 |
|
||||
| **Balance** | Bots (random, greedy, lookahead) played thousands of matches per ruleset. On v1 the starter pairings ranged 23–77%, and the first player won 53.4%. The v1.1 re-run measured the first player at **51.2%**, starter decks at **52–53%** and owned decks at **42–51%** against starters, so owning NFTs adds variety, not power. | `docs/game/BALANCE.md`, `shared/bots/` #14 |
|
||||
| **eom.dev accounts** | Dex OIDC with PKCE: login and logout, and ID tokens verified against the JWKS. Wallet linking signs a message the **client builds**, never text from the server. The account ↔ wallet map is stored off-chain. | `server/account/`, `src/auth/`, #15 #37 #42 |
|
||||
| **Peer-hosted modes** | Modes are JSON data, never code. A node publishes them at `GET /api/game/modes`, peers are discovered through config, and the hosting node runs the match. It shows "Hosted by", with per-mode and host leaderboards. 3 example modes: classic, snake draft and trending. Lobbies survive restarts. | `shared/game/modes.ts`, `server/game/`, `docs/game/HOSTING.md`, #22 #43 |
|
||||
| **Private testnet** | 3 nodes on poweredge-r350, LAN only, at height 50. Auto-redeploy followed this branch until the freeze, with rolling restarts that wait for live matches to finish. | `deploy/night/`, #16 #19 #39 #40 |
|
||||
| **Android app** | Capacitor 7 (`dev.eom.wikideck`). A debug APK runs a full match against the AI in the emulator. CapacitorHttp gets past the node's Origin check with no server change. The SSO deep link round trip works up to Dex. | `android/`, `docs/night/ANDROID.md`, #35 #41 #44 |
|
||||
| **iOS app** | Capacitor 7 iOS project (SPM) and a simulator build script. The macOS Sequoia VM's install was still running at the end of the night. No Apple ID was used. | `ios/`, `docs/night/IOS.md`, #34 #52 |
|
||||
|
||||
## How to try it
|
||||
- **Browser:** http://192.168.1.32:3101, :3102 or :3103 (LAN only). Open **Play**, dismiss the tutorial, pick a starter deck and play the AI. The three nodes host different modes: A has classic and trending, B has draft, and C has all three.
|
||||
- **Android:** the APK is at `inspiron-3670:~/worker/jobs/night/mobile-android/apk/wikideck-night1-debug.apk` (debug-signed, testnet build). To rebuild it: `android/build-debug.sh`. Screenshots:
|
||||
|
||||

|
||||
- **iOS:** follow Eric's checklist in `docs/night/IOS.md`:
|
||||
1. resume the VM on inspiron and finish the macOS install
|
||||
2. sign in with your Apple ID
|
||||
3. install Xcode
|
||||
4. run `scripts/ios/build-sim.sh`
|
||||
|
||||
No Apple ID was used tonight. The VM got as far as the Sequoia installer downloading the full OS. Per the coordinator, the VM is shut down cleanly before 01:30 with its disk kept. `docs/night/IOS.md` (#52) records the install progress at shutdown, the resume steps and Eric's checklist.
|
||||
- **Login:** "Log in with eom.dev" uses Dex at `https://dex.eom.dev/`, through the `wikideck` public client that the coordinator applied. You need a membership account that's in `Dex Users`; the SSO issue #7 covers the sign-up path.
|
||||
|
||||
## QA (night-review, live testnet)
|
||||
- **API:** full hosted matches in all 3 modes (classic @A, snake draft @B, trending @C) with two scripted players. Records and leaderboards are correct. Rejected as they should be: forged card, cross-seat token, random token, client `timeout`, foreign Origin, self-join, out-of-turn pick.
|
||||
- **Browser:** Playwright played 3 full matches against the AI through the real Play UI (360×740 @A ×2, 1280×800 @B). Every one reached results, with no overflow, stuck turns or page errors.
|
||||
- **Engine fuzz:** 300 random matches per engine branch. 0 `viewFor` leaks (information-flow test), and every replay was deterministic.
|
||||
- **UX bug found and fixed:** the results card showed tied Topics ("13–13 Lost") with no tie-break explanation. Fixed after the freeze in #51.
|
||||
|
||||
## Known issues and gaps
|
||||
1. **The game ships rules v1.1** (`DEFAULT_RULESET = RULESET_V1_1`, #36), which matches DESIGN.md v1.1. The v1.1 numbers in BALANCE.md (first player 51.2%, starter decks 52–53%, owned decks 42–51%) were measured **before** #38 hid the opponent's queue, so the seat figure needs a re-run. Item 6 (`nostalgic` and `translated` at −1 power) is a v1.2 candidate and isn't in v1.1.
|
||||
2. **Hosted PvP trusts the host.** The seed is chosen by the host, and DESIGN §4.4's commit–reveal isn't implemented. A malicious host can see both hands. That's documented in HOSTING.md.
|
||||
3. **Hidden information.** #38 hides the opponent's queue during planning (with a test). The UI and the bots consume only `viewFor` output, and the log never names an opponent's hidden card. Remaining: `obscure` (item 4) and host trust (item 2).
|
||||
4. **The `obscure` keyword isn't masked in `viewFor`.** Modes reject it, so it can't be turned on.
|
||||
5. **Game traffic shares the chain's per-node RPC budget,** so one hot client can get everyone 503s (#6).
|
||||
6. **Wikipedia rate limits:** our egress IP got HTTP 429s on the action API. #19 adds an optional `WIKIDECK_USER_AGENT` with a contact URL, and only the testnet sets it. **The live deployment probably shares that IP and the old generic UA.** Whether to set it in production is Eric's decision.
|
||||
7. **Mobile polish:**
|
||||
- the dashed lane drop zone doesn't take taps, only the lane plate does
|
||||
- the home hero still says "Explore mining" inside the app
|
||||
- the real SSO login hasn't been done on a device yet
|
||||
- **Apple licences:** an agent clicked through the **macOS installer licence** in the VM, under Eric's VM approval on #9. Review that if you want to accept it yourself.
|
||||
- `scripts/ios/build-sim.sh` still runs `sudo xcodebuild -license accept`, which would accept Apple's Xcode licence on Eric's behalf. **Eric should accept it himself** (remove the line first).
|
||||
- Android allows cleartext HTTP to **any** host (`usesCleartextTraffic="true"`). Before any non-LAN use, restrict it with a `network_security_config` to the testnet host.
|
||||
8. **Factions are skewed:** owned cards are about 53% Culture and 0% Space, so `viral` and `local` dominate. Factions built on Wikidata P31 are the v1.1+ fix (CARD_DATA findings 6 and 7).
|
||||
9. **Tooling:** the repo needs **Node 24** (`node:sqlite`). On Node 20, 12 tests fail falsely. Every gate tonight ran in `node:24-alpine`.
|
||||
|
||||
**Held for Eric:** #49 (the normal bot uses sim-balance's lookahead). It's approved, but it's a behaviour change that arrived after the freeze.
|
||||
|
||||
## Next steps (in priority order)
|
||||
1. **Re-run balance on the final head** (after #38) and decide v1.2 item 6. The harness is `scripts/sim/` and `shared/bots/`, and it needs about 1 GB on r350, run under the heavy lock.
|
||||
2. **Hidden information everywhere:** mask `obscure`, and implement the §4.4 commit–reveal seed for hosted PvP.
|
||||
3. **Separate rate limits for game traffic** on the node, so they don't share the chain's RPC budget.
|
||||
4. **Finish iOS:** Xcode and a simulator run, then the same match against the AI as on Android.
|
||||
5. **SSO end to end** on a device with a real eom.dev account, then show account names on the leaderboards.
|
||||
6. **Factions from Wikidata P31**, then re-run the balance sims (item 6 on the BALANCE list is still open).
|
||||
7. **Host incentives on-chain:** the proposal in HOSTING.md. It's a protocol change, so it needs its own review.
|
||||
8. **Production user agent:** decide whether the live node should set `WIKIDECK_USER_AGENT`.
|
||||
|
||||
## Process notes
|
||||
- Every agent shared the `claude` Gitea account, so night-review approved with COMMENT reviews that start with `VERDICT: APPROVED`, naming the head SHA and the gate result.
|
||||
- **imac's Gitea MCP was down** all night. The council read issues anonymously and reported through PR bodies, and night-lead relayed.
|
||||
- **tower-plus ran out of memory** at about 23:25, and **r350 twice**. From then on, every heavy check ran on inspiron in `node:24-alpine` under `flock /tmp/night-heavy.lock`.
|
||||
- Squash merges dropped the history that stacked PRs shared, which caused add/add conflicts (#27, #22, #26). Each was resolved mechanically, with no content changes.
|
||||
|
After Width: | Height: | Size: 143 KiB |
@@ -0,0 +1,13 @@
|
||||
App/build
|
||||
App/Pods
|
||||
App/output
|
||||
App/App/public
|
||||
DerivedData
|
||||
xcuserdata
|
||||
|
||||
# Cordova plugins for Capacitor
|
||||
capacitor-cordova-ios-plugins
|
||||
|
||||
# Generated Config files
|
||||
App/App/capacitor.config.json
|
||||
App/App/config.xml
|
||||
@@ -0,0 +1,376 @@
|
||||
// !$*UTF8*$!
|
||||
{
|
||||
archiveVersion = 1;
|
||||
classes = {
|
||||
};
|
||||
objectVersion = 60;
|
||||
objects = {
|
||||
|
||||
/* Begin PBXBuildFile section */
|
||||
2FAD9763203C412B000D30F8 /* config.xml in Resources */ = {isa = PBXBuildFile; fileRef = 2FAD9762203C412B000D30F8 /* config.xml */; };
|
||||
4D22ABE92AF431CB00220026 /* CapApp-SPM in Frameworks */ = {isa = PBXBuildFile; productRef = 4D22ABE82AF431CB00220026 /* CapApp-SPM */; };
|
||||
50379B232058CBB4000EE86E /* capacitor.config.json in Resources */ = {isa = PBXBuildFile; fileRef = 50379B222058CBB4000EE86E /* capacitor.config.json */; };
|
||||
504EC3081FED79650016851F /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 504EC3071FED79650016851F /* AppDelegate.swift */; };
|
||||
504EC30D1FED79650016851F /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 504EC30B1FED79650016851F /* Main.storyboard */; };
|
||||
504EC30F1FED79650016851F /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 504EC30E1FED79650016851F /* Assets.xcassets */; };
|
||||
504EC3121FED79650016851F /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 504EC3101FED79650016851F /* LaunchScreen.storyboard */; };
|
||||
50B271D11FEDC1A000F3C39B /* public in Resources */ = {isa = PBXBuildFile; fileRef = 50B271D01FEDC1A000F3C39B /* public */; };
|
||||
/* End PBXBuildFile section */
|
||||
|
||||
/* Begin PBXFileReference section */
|
||||
2FAD9762203C412B000D30F8 /* config.xml */ = {isa = PBXFileReference; lastKnownFileType = text.xml; path = config.xml; sourceTree = "<group>"; };
|
||||
50379B222058CBB4000EE86E /* capacitor.config.json */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.json; path = capacitor.config.json; sourceTree = "<group>"; };
|
||||
504EC3041FED79650016851F /* App.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = App.app; sourceTree = BUILT_PRODUCTS_DIR; };
|
||||
504EC3071FED79650016851F /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
|
||||
504EC30C1FED79650016851F /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
|
||||
504EC30E1FED79650016851F /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
|
||||
504EC3111FED79650016851F /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = "<group>"; };
|
||||
504EC3131FED79650016851F /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
|
||||
50B271D01FEDC1A000F3C39B /* public */ = {isa = PBXFileReference; lastKnownFileType = folder; path = public; sourceTree = "<group>"; };
|
||||
958DCC722DB07C7200EA8C5F /* debug.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = debug.xcconfig; path = ../debug.xcconfig; sourceTree = SOURCE_ROOT; };
|
||||
/* End PBXFileReference section */
|
||||
|
||||
/* Begin PBXFrameworksBuildPhase section */
|
||||
504EC3011FED79650016851F /* Frameworks */ = {
|
||||
isa = PBXFrameworksBuildPhase;
|
||||
buildActionMask = 2147483647;
|
||||
files = (
|
||||
4D22ABE92AF431CB00220026 /* CapApp-SPM in Frameworks */,
|
||||
);
|
||||
runOnlyForDeploymentPostprocessing = 0;
|
||||
};
|
||||
/* End PBXFrameworksBuildPhase section */
|
||||
|
||||
/* Begin PBXGroup section */
|
||||
504EC2FB1FED79650016851F = {
|
||||
isa = PBXGroup;
|
||||
children = (
|
||||
958DCC722DB07C7200EA8C5F /* debug.xcconfig */,
|
||||
504EC3061FED79650016851F /* App */,
|
||||
504EC3051FED79650016851F /* Products */,
|
||||
);
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
504EC3051FED79650016851F /* Products */ = {
|
||||
isa = PBXGroup;
|
||||
children = (
|
||||
504EC3041FED79650016851F /* App.app */,
|
||||
);
|
||||
name = Products;
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
504EC3061FED79650016851F /* App */ = {
|
||||
isa = PBXGroup;
|
||||
children = (
|
||||
50379B222058CBB4000EE86E /* capacitor.config.json */,
|
||||
504EC3071FED79650016851F /* AppDelegate.swift */,
|
||||
504EC30B1FED79650016851F /* Main.storyboard */,
|
||||
504EC30E1FED79650016851F /* Assets.xcassets */,
|
||||
504EC3101FED79650016851F /* LaunchScreen.storyboard */,
|
||||
504EC3131FED79650016851F /* Info.plist */,
|
||||
2FAD9762203C412B000D30F8 /* config.xml */,
|
||||
50B271D01FEDC1A000F3C39B /* public */,
|
||||
);
|
||||
path = App;
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
/* End PBXGroup section */
|
||||
|
||||
/* Begin PBXNativeTarget section */
|
||||
504EC3031FED79650016851F /* App */ = {
|
||||
isa = PBXNativeTarget;
|
||||
buildConfigurationList = 504EC3161FED79650016851F /* Build configuration list for PBXNativeTarget "App" */;
|
||||
buildPhases = (
|
||||
504EC3001FED79650016851F /* Sources */,
|
||||
504EC3011FED79650016851F /* Frameworks */,
|
||||
504EC3021FED79650016851F /* Resources */,
|
||||
);
|
||||
buildRules = (
|
||||
);
|
||||
dependencies = (
|
||||
);
|
||||
name = App;
|
||||
packageProductDependencies = (
|
||||
4D22ABE82AF431CB00220026 /* CapApp-SPM */,
|
||||
);
|
||||
productName = App;
|
||||
productReference = 504EC3041FED79650016851F /* App.app */;
|
||||
productType = "com.apple.product-type.application";
|
||||
};
|
||||
/* End PBXNativeTarget section */
|
||||
|
||||
/* Begin PBXProject section */
|
||||
504EC2FC1FED79650016851F /* Project object */ = {
|
||||
isa = PBXProject;
|
||||
attributes = {
|
||||
LastSwiftUpdateCheck = 0920;
|
||||
LastUpgradeCheck = 0920;
|
||||
TargetAttributes = {
|
||||
504EC3031FED79650016851F = {
|
||||
CreatedOnToolsVersion = 9.2;
|
||||
LastSwiftMigration = 1100;
|
||||
ProvisioningStyle = Automatic;
|
||||
};
|
||||
};
|
||||
};
|
||||
buildConfigurationList = 504EC2FF1FED79650016851F /* Build configuration list for PBXProject "App" */;
|
||||
compatibilityVersion = "Xcode 8.0";
|
||||
developmentRegion = en;
|
||||
hasScannedForEncodings = 0;
|
||||
knownRegions = (
|
||||
en,
|
||||
Base,
|
||||
);
|
||||
mainGroup = 504EC2FB1FED79650016851F;
|
||||
packageReferences = (
|
||||
D4C12C0A2AAA248700AAC8A2 /* XCLocalSwiftPackageReference "CapApp-SPM" */,
|
||||
);
|
||||
productRefGroup = 504EC3051FED79650016851F /* Products */;
|
||||
projectDirPath = "";
|
||||
projectRoot = "";
|
||||
targets = (
|
||||
504EC3031FED79650016851F /* App */,
|
||||
);
|
||||
};
|
||||
/* End PBXProject section */
|
||||
|
||||
/* Begin PBXResourcesBuildPhase section */
|
||||
504EC3021FED79650016851F /* Resources */ = {
|
||||
isa = PBXResourcesBuildPhase;
|
||||
buildActionMask = 2147483647;
|
||||
files = (
|
||||
504EC3121FED79650016851F /* LaunchScreen.storyboard in Resources */,
|
||||
50B271D11FEDC1A000F3C39B /* public in Resources */,
|
||||
504EC30F1FED79650016851F /* Assets.xcassets in Resources */,
|
||||
50379B232058CBB4000EE86E /* capacitor.config.json in Resources */,
|
||||
504EC30D1FED79650016851F /* Main.storyboard in Resources */,
|
||||
2FAD9763203C412B000D30F8 /* config.xml in Resources */,
|
||||
);
|
||||
runOnlyForDeploymentPostprocessing = 0;
|
||||
};
|
||||
/* End PBXResourcesBuildPhase section */
|
||||
|
||||
/* Begin PBXSourcesBuildPhase section */
|
||||
504EC3001FED79650016851F /* Sources */ = {
|
||||
isa = PBXSourcesBuildPhase;
|
||||
buildActionMask = 2147483647;
|
||||
files = (
|
||||
504EC3081FED79650016851F /* AppDelegate.swift in Sources */,
|
||||
);
|
||||
runOnlyForDeploymentPostprocessing = 0;
|
||||
};
|
||||
/* End PBXSourcesBuildPhase section */
|
||||
|
||||
/* Begin PBXVariantGroup section */
|
||||
504EC30B1FED79650016851F /* Main.storyboard */ = {
|
||||
isa = PBXVariantGroup;
|
||||
children = (
|
||||
504EC30C1FED79650016851F /* Base */,
|
||||
);
|
||||
name = Main.storyboard;
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
504EC3101FED79650016851F /* LaunchScreen.storyboard */ = {
|
||||
isa = PBXVariantGroup;
|
||||
children = (
|
||||
504EC3111FED79650016851F /* Base */,
|
||||
);
|
||||
name = LaunchScreen.storyboard;
|
||||
sourceTree = "<group>";
|
||||
};
|
||||
/* End PBXVariantGroup section */
|
||||
|
||||
/* Begin XCBuildConfiguration section */
|
||||
504EC3141FED79650016851F /* Debug */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
baseConfigurationReference = 958DCC722DB07C7200EA8C5F /* debug.xcconfig */;
|
||||
buildSettings = {
|
||||
ALWAYS_SEARCH_USER_PATHS = NO;
|
||||
CLANG_ANALYZER_NONNULL = YES;
|
||||
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
|
||||
CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
|
||||
CLANG_CXX_LIBRARY = "libc++";
|
||||
CLANG_ENABLE_MODULES = YES;
|
||||
CLANG_ENABLE_OBJC_ARC = YES;
|
||||
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
|
||||
CLANG_WARN_BOOL_CONVERSION = YES;
|
||||
CLANG_WARN_COMMA = YES;
|
||||
CLANG_WARN_CONSTANT_CONVERSION = YES;
|
||||
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
|
||||
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
|
||||
CLANG_WARN_EMPTY_BODY = YES;
|
||||
CLANG_WARN_ENUM_CONVERSION = YES;
|
||||
CLANG_WARN_INFINITE_RECURSION = YES;
|
||||
CLANG_WARN_INT_CONVERSION = YES;
|
||||
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
|
||||
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
|
||||
CLANG_WARN_STRICT_PROTOTYPES = YES;
|
||||
CLANG_WARN_SUSPICIOUS_MOVE = YES;
|
||||
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
|
||||
CLANG_WARN_UNREACHABLE_CODE = YES;
|
||||
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
|
||||
CODE_SIGN_IDENTITY = "iPhone Developer";
|
||||
COPY_PHASE_STRIP = NO;
|
||||
DEBUG_INFORMATION_FORMAT = dwarf;
|
||||
ENABLE_STRICT_OBJC_MSGSEND = YES;
|
||||
ENABLE_TESTABILITY = YES;
|
||||
GCC_C_LANGUAGE_STANDARD = gnu11;
|
||||
GCC_DYNAMIC_NO_PIC = NO;
|
||||
GCC_NO_COMMON_BLOCKS = YES;
|
||||
GCC_OPTIMIZATION_LEVEL = 0;
|
||||
GCC_PREPROCESSOR_DEFINITIONS = (
|
||||
"DEBUG=1",
|
||||
"$(inherited)",
|
||||
);
|
||||
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
|
||||
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
|
||||
GCC_WARN_UNDECLARED_SELECTOR = YES;
|
||||
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
|
||||
GCC_WARN_UNUSED_FUNCTION = YES;
|
||||
GCC_WARN_UNUSED_VARIABLE = YES;
|
||||
IPHONEOS_DEPLOYMENT_TARGET = 14.0;
|
||||
MTL_ENABLE_DEBUG_INFO = YES;
|
||||
ONLY_ACTIVE_ARCH = YES;
|
||||
SDKROOT = iphoneos;
|
||||
SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
|
||||
SWIFT_OPTIMIZATION_LEVEL = "-Onone";
|
||||
};
|
||||
name = Debug;
|
||||
};
|
||||
504EC3151FED79650016851F /* Release */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
buildSettings = {
|
||||
ALWAYS_SEARCH_USER_PATHS = NO;
|
||||
CLANG_ANALYZER_NONNULL = YES;
|
||||
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
|
||||
CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
|
||||
CLANG_CXX_LIBRARY = "libc++";
|
||||
CLANG_ENABLE_MODULES = YES;
|
||||
CLANG_ENABLE_OBJC_ARC = YES;
|
||||
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
|
||||
CLANG_WARN_BOOL_CONVERSION = YES;
|
||||
CLANG_WARN_COMMA = YES;
|
||||
CLANG_WARN_CONSTANT_CONVERSION = YES;
|
||||
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
|
||||
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
|
||||
CLANG_WARN_EMPTY_BODY = YES;
|
||||
CLANG_WARN_ENUM_CONVERSION = YES;
|
||||
CLANG_WARN_INFINITE_RECURSION = YES;
|
||||
CLANG_WARN_INT_CONVERSION = YES;
|
||||
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
|
||||
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
|
||||
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
|
||||
CLANG_WARN_STRICT_PROTOTYPES = YES;
|
||||
CLANG_WARN_SUSPICIOUS_MOVE = YES;
|
||||
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
|
||||
CLANG_WARN_UNREACHABLE_CODE = YES;
|
||||
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
|
||||
CODE_SIGN_IDENTITY = "iPhone Developer";
|
||||
COPY_PHASE_STRIP = NO;
|
||||
DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
|
||||
ENABLE_NS_ASSERTIONS = NO;
|
||||
ENABLE_STRICT_OBJC_MSGSEND = YES;
|
||||
GCC_C_LANGUAGE_STANDARD = gnu11;
|
||||
GCC_NO_COMMON_BLOCKS = YES;
|
||||
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
|
||||
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
|
||||
GCC_WARN_UNDECLARED_SELECTOR = YES;
|
||||
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
|
||||
GCC_WARN_UNUSED_FUNCTION = YES;
|
||||
GCC_WARN_UNUSED_VARIABLE = YES;
|
||||
IPHONEOS_DEPLOYMENT_TARGET = 14.0;
|
||||
MTL_ENABLE_DEBUG_INFO = NO;
|
||||
SDKROOT = iphoneos;
|
||||
SWIFT_COMPILATION_MODE = wholemodule;
|
||||
SWIFT_OPTIMIZATION_LEVEL = "-O";
|
||||
VALIDATE_PRODUCT = YES;
|
||||
};
|
||||
name = Release;
|
||||
};
|
||||
504EC3171FED79650016851F /* Debug */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
baseConfigurationReference = 958DCC722DB07C7200EA8C5F /* debug.xcconfig */;
|
||||
buildSettings = {
|
||||
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
|
||||
CODE_SIGN_STYLE = Automatic;
|
||||
CURRENT_PROJECT_VERSION = 1;
|
||||
INFOPLIST_FILE = App/Info.plist;
|
||||
IPHONEOS_DEPLOYMENT_TARGET = 14.0;
|
||||
LD_RUNPATH_SEARCH_PATHS = (
|
||||
"$(inherited)",
|
||||
"@executable_path/Frameworks",
|
||||
);
|
||||
MARKETING_VERSION = 1.0;
|
||||
OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
|
||||
PRODUCT_BUNDLE_IDENTIFIER = dev.eom.wikideck;
|
||||
PRODUCT_NAME = "$(TARGET_NAME)";
|
||||
SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
|
||||
SWIFT_VERSION = 5.0;
|
||||
TARGETED_DEVICE_FAMILY = "1,2";
|
||||
};
|
||||
name = Debug;
|
||||
};
|
||||
504EC3181FED79650016851F /* Release */ = {
|
||||
isa = XCBuildConfiguration;
|
||||
buildSettings = {
|
||||
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
|
||||
CODE_SIGN_STYLE = Automatic;
|
||||
CURRENT_PROJECT_VERSION = 1;
|
||||
INFOPLIST_FILE = App/Info.plist;
|
||||
IPHONEOS_DEPLOYMENT_TARGET = 14.0;
|
||||
LD_RUNPATH_SEARCH_PATHS = (
|
||||
"$(inherited)",
|
||||
"@executable_path/Frameworks",
|
||||
);
|
||||
MARKETING_VERSION = 1.0;
|
||||
PRODUCT_BUNDLE_IDENTIFIER = dev.eom.wikideck;
|
||||
PRODUCT_NAME = "$(TARGET_NAME)";
|
||||
SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";
|
||||
SWIFT_VERSION = 5.0;
|
||||
TARGETED_DEVICE_FAMILY = "1,2";
|
||||
};
|
||||
name = Release;
|
||||
};
|
||||
/* End XCBuildConfiguration section */
|
||||
|
||||
/* Begin XCConfigurationList section */
|
||||
504EC2FF1FED79650016851F /* Build configuration list for PBXProject "App" */ = {
|
||||
isa = XCConfigurationList;
|
||||
buildConfigurations = (
|
||||
504EC3141FED79650016851F /* Debug */,
|
||||
504EC3151FED79650016851F /* Release */,
|
||||
);
|
||||
defaultConfigurationIsVisible = 0;
|
||||
defaultConfigurationName = Release;
|
||||
};
|
||||
504EC3161FED79650016851F /* Build configuration list for PBXNativeTarget "App" */ = {
|
||||
isa = XCConfigurationList;
|
||||
buildConfigurations = (
|
||||
504EC3171FED79650016851F /* Debug */,
|
||||
504EC3181FED79650016851F /* Release */,
|
||||
);
|
||||
defaultConfigurationIsVisible = 0;
|
||||
defaultConfigurationName = Release;
|
||||
};
|
||||
/* End XCConfigurationList section */
|
||||
|
||||
/* Begin XCLocalSwiftPackageReference section */
|
||||
D4C12C0A2AAA248700AAC8A2 /* XCLocalSwiftPackageReference "CapApp-SPM" */ = {
|
||||
isa = XCLocalSwiftPackageReference;
|
||||
relativePath = "CapApp-SPM";
|
||||
};
|
||||
/* End XCLocalSwiftPackageReference section */
|
||||
|
||||
/* Begin XCSwiftPackageProductDependency section */
|
||||
4D22ABE82AF431CB00220026 /* CapApp-SPM */ = {
|
||||
isa = XCSwiftPackageProductDependency;
|
||||
package = D4C12C0A2AAA248700AAC8A2 /* XCLocalSwiftPackageReference "CapApp-SPM" */;
|
||||
productName = "CapApp-SPM";
|
||||
};
|
||||
/* End XCSwiftPackageProductDependency section */
|
||||
};
|
||||
rootObject = 504EC2FC1FED79650016851F /* Project object */;
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>IDEDidComputeMac32BitWarning</key>
|
||||
<true/>
|
||||
</dict>
|
||||
</plist>
|
||||
@@ -0,0 +1,49 @@
|
||||
import UIKit
|
||||
import Capacitor
|
||||
|
||||
@UIApplicationMain
|
||||
class AppDelegate: UIResponder, UIApplicationDelegate {
|
||||
|
||||
var window: UIWindow?
|
||||
|
||||
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
|
||||
// Override point for customization after application launch.
|
||||
return true
|
||||
}
|
||||
|
||||
func applicationWillResignActive(_ application: UIApplication) {
|
||||
// Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
|
||||
// Use this method to pause ongoing tasks, disable timers, and invalidate graphics rendering callbacks. Games should use this method to pause the game.
|
||||
}
|
||||
|
||||
func applicationDidEnterBackground(_ application: UIApplication) {
|
||||
// Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
|
||||
// If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
|
||||
}
|
||||
|
||||
func applicationWillEnterForeground(_ application: UIApplication) {
|
||||
// Called as part of the transition from the background to the active state; here you can undo many of the changes made on entering the background.
|
||||
}
|
||||
|
||||
func applicationDidBecomeActive(_ application: UIApplication) {
|
||||
// Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
|
||||
}
|
||||
|
||||
func applicationWillTerminate(_ application: UIApplication) {
|
||||
// Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
|
||||
}
|
||||
|
||||
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
|
||||
// Called when the app was launched with a url. Feel free to add additional processing here,
|
||||
// but if you want the App API to support tracking app url opens, make sure to keep this call
|
||||
return ApplicationDelegateProxy.shared.application(app, open: url, options: options)
|
||||
}
|
||||
|
||||
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
|
||||
// Called when the app was launched with an activity, including Universal Links.
|
||||
// Feel free to add additional processing here, but if you want the App API to support
|
||||
// tracking app url opens, make sure to keep this call
|
||||
return ApplicationDelegateProxy.shared.application(application, continue: userActivity, restorationHandler: restorationHandler)
|
||||
}
|
||||
|
||||
}
|
||||
|
After Width: | Height: | Size: 108 KiB |
@@ -0,0 +1,14 @@
|
||||
{
|
||||
"images" : [
|
||||
{
|
||||
"filename" : "AppIcon-512@2x.png",
|
||||
"idiom" : "universal",
|
||||
"platform" : "ios",
|
||||
"size" : "1024x1024"
|
||||
}
|
||||
],
|
||||
"info" : {
|
||||
"author" : "xcode",
|
||||
"version" : 1
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"info" : {
|
||||
"version" : 1,
|
||||
"author" : "xcode"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
{
|
||||
"images" : [
|
||||
{
|
||||
"idiom" : "universal",
|
||||
"filename" : "splash-2732x2732-2.png",
|
||||
"scale" : "1x"
|
||||
},
|
||||
{
|
||||
"idiom" : "universal",
|
||||
"filename" : "splash-2732x2732-1.png",
|
||||
"scale" : "2x"
|
||||
},
|
||||
{
|
||||
"idiom" : "universal",
|
||||
"filename" : "splash-2732x2732.png",
|
||||
"scale" : "3x"
|
||||
}
|
||||
],
|
||||
"info" : {
|
||||
"version" : 1,
|
||||
"author" : "xcode"
|
||||
}
|
||||
}
|
||||
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 40 KiB |
@@ -0,0 +1,32 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="17132" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
|
||||
<device id="retina4_7" orientation="portrait" appearance="light"/>
|
||||
<dependencies>
|
||||
<deployment identifier="iOS"/>
|
||||
<plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="17105"/>
|
||||
<capability name="System colors in document resources" minToolsVersion="11.0"/>
|
||||
<capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
|
||||
</dependencies>
|
||||
<scenes>
|
||||
<!--View Controller-->
|
||||
<scene sceneID="EHf-IW-A2E">
|
||||
<objects>
|
||||
<viewController id="01J-lp-oVM" sceneMemberID="viewController">
|
||||
<imageView key="view" userInteractionEnabled="NO" contentMode="scaleAspectFill" horizontalHuggingPriority="251" verticalHuggingPriority="251" image="Splash" id="snD-IY-ifK">
|
||||
<rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
|
||||
<autoresizingMask key="autoresizingMask"/>
|
||||
<color key="backgroundColor" systemColor="systemBackgroundColor"/>
|
||||
</imageView>
|
||||
</viewController>
|
||||
<placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
|
||||
</objects>
|
||||
<point key="canvasLocation" x="53" y="375"/>
|
||||
</scene>
|
||||
</scenes>
|
||||
<resources>
|
||||
<image name="Splash" width="1366" height="1366"/>
|
||||
<systemColor name="systemBackgroundColor">
|
||||
<color white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
|
||||
</systemColor>
|
||||
</resources>
|
||||
</document>
|
||||
@@ -0,0 +1,19 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="14111" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="BYZ-38-t0r">
|
||||
<device id="retina4_7" orientation="portrait">
|
||||
<adaptation id="fullscreen"/>
|
||||
</device>
|
||||
<dependencies>
|
||||
<deployment identifier="iOS"/>
|
||||
<plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="14088"/>
|
||||
</dependencies>
|
||||
<scenes>
|
||||
<!--Bridge View Controller-->
|
||||
<scene sceneID="tne-QT-ifu">
|
||||
<objects>
|
||||
<viewController id="BYZ-38-t0r" customClass="CAPBridgeViewController" customModule="Capacitor" sceneMemberID="viewController"/>
|
||||
<placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
|
||||
</objects>
|
||||
</scene>
|
||||
</scenes>
|
||||
</document>
|
||||
@@ -0,0 +1,67 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>CAPACITOR_DEBUG</key>
|
||||
<string>$(CAPACITOR_DEBUG)</string>
|
||||
<key>CFBundleDevelopmentRegion</key>
|
||||
<string>en</string>
|
||||
<key>CFBundleDisplayName</key>
|
||||
<string>WikiDeck</string>
|
||||
<key>CFBundleExecutable</key>
|
||||
<string>$(EXECUTABLE_NAME)</string>
|
||||
<key>CFBundleIdentifier</key>
|
||||
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
|
||||
<key>CFBundleInfoDictionaryVersion</key>
|
||||
<string>6.0</string>
|
||||
<key>CFBundleName</key>
|
||||
<string>$(PRODUCT_NAME)</string>
|
||||
<key>CFBundlePackageType</key>
|
||||
<string>APPL</string>
|
||||
<key>CFBundleShortVersionString</key>
|
||||
<string>$(MARKETING_VERSION)</string>
|
||||
<key>CFBundleVersion</key>
|
||||
<string>$(CURRENT_PROJECT_VERSION)</string>
|
||||
<key>LSRequiresIPhoneOS</key>
|
||||
<true/>
|
||||
<key>UILaunchStoryboardName</key>
|
||||
<string>LaunchScreen</string>
|
||||
<key>UIMainStoryboardFile</key>
|
||||
<string>Main</string>
|
||||
<key>UIRequiredDeviceCapabilities</key>
|
||||
<array>
|
||||
<string>armv7</string>
|
||||
</array>
|
||||
<key>UISupportedInterfaceOrientations</key>
|
||||
<array>
|
||||
<string>UIInterfaceOrientationPortrait</string>
|
||||
<string>UIInterfaceOrientationLandscapeLeft</string>
|
||||
<string>UIInterfaceOrientationLandscapeRight</string>
|
||||
</array>
|
||||
<key>UISupportedInterfaceOrientations~ipad</key>
|
||||
<array>
|
||||
<string>UIInterfaceOrientationPortrait</string>
|
||||
<string>UIInterfaceOrientationPortraitUpsideDown</string>
|
||||
<string>UIInterfaceOrientationLandscapeLeft</string>
|
||||
<string>UIInterfaceOrientationLandscapeRight</string>
|
||||
</array>
|
||||
<key>UIViewControllerBasedStatusBarAppearance</key>
|
||||
<true/>
|
||||
<key>CFBundleURLTypes</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>CFBundleURLName</key>
|
||||
<string>dev.eom.wikideck</string>
|
||||
<key>CFBundleURLSchemes</key>
|
||||
<array>
|
||||
<string>dev.eom.wikideck</string>
|
||||
</array>
|
||||
</dict>
|
||||
</array>
|
||||
<key>NSAppTransportSecurity</key>
|
||||
<dict>
|
||||
<key>NSAllowsLocalNetworking</key>
|
||||
<true/>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
@@ -0,0 +1,9 @@
|
||||
.DS_Store
|
||||
/.build
|
||||
/Packages
|
||||
/*.xcodeproj
|
||||
xcuserdata/
|
||||
DerivedData/
|
||||
.swiftpm/config/registries.json
|
||||
.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
|
||||
.netrc
|
||||
@@ -0,0 +1,29 @@
|
||||
// swift-tools-version: 5.9
|
||||
import PackageDescription
|
||||
|
||||
// DO NOT MODIFY THIS FILE - managed by Capacitor CLI commands
|
||||
let package = Package(
|
||||
name: "CapApp-SPM",
|
||||
platforms: [.iOS(.v14)],
|
||||
products: [
|
||||
.library(
|
||||
name: "CapApp-SPM",
|
||||
targets: ["CapApp-SPM"])
|
||||
],
|
||||
dependencies: [
|
||||
.package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", exact: "7.6.10"),
|
||||
.package(name: "CapacitorApp", path: "../../../node_modules/@capacitor/app"),
|
||||
.package(name: "CapacitorBrowser", path: "../../../node_modules/@capacitor/browser")
|
||||
],
|
||||
targets: [
|
||||
.target(
|
||||
name: "CapApp-SPM",
|
||||
dependencies: [
|
||||
.product(name: "Capacitor", package: "capacitor-swift-pm"),
|
||||
.product(name: "Cordova", package: "capacitor-swift-pm"),
|
||||
.product(name: "CapacitorApp", package: "CapacitorApp"),
|
||||
.product(name: "CapacitorBrowser", package: "CapacitorBrowser")
|
||||
]
|
||||
)
|
||||
]
|
||||
)
|
||||
@@ -0,0 +1,5 @@
|
||||
# CapApp-SPM
|
||||
|
||||
This SPM is used to host SPM dependencies for you Capacitor project
|
||||
|
||||
Do not modify the contents of it or there may be unintended consequences.
|
||||
@@ -0,0 +1 @@
|
||||
public let isCapacitorApp = true
|
||||
@@ -0,0 +1 @@
|
||||
CAPACITOR_DEBUG = true
|
||||
@@ -22,6 +22,11 @@
|
||||
"test": "node scripts/run-tests.mjs"
|
||||
},
|
||||
"dependencies": {
|
||||
"@capacitor/android": "^7.6.10",
|
||||
"@capacitor/app": "^7.1.2",
|
||||
"@capacitor/browser": "^7.0.5",
|
||||
"@capacitor/core": "^7.6.10",
|
||||
"@capacitor/ios": "^7.6.10",
|
||||
"express": "^5.1.0",
|
||||
"express-rate-limit": "^8.1.0",
|
||||
"hash-wasm": "^4.12.0",
|
||||
@@ -32,6 +37,7 @@
|
||||
"zod": "^4.1.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@capacitor/cli": "^7.6.10",
|
||||
"@types/express": "^5.0.3",
|
||||
"@types/node": "^24.0.0",
|
||||
"@types/react": "^19.1.0",
|
||||
|
||||
@@ -0,0 +1,51 @@
|
||||
#!/usr/bin/env node
|
||||
// Generates shared/game/card-data.ts from council-data's frozen files (docs/game/*.json).
|
||||
// The engine does no I/O, so the data is embedded as constants. Rerun after the JSON changes:
|
||||
// node scripts/game-card-data.mjs
|
||||
import { readFileSync, writeFileSync } from 'node:fs';
|
||||
|
||||
const root = new URL('../', import.meta.url);
|
||||
const sample = JSON.parse(readFileSync(new URL('docs/game/card-sample.json', root), 'utf8'));
|
||||
const starter = JSON.parse(readFileSync(new URL('docs/game/starter-cards.json', root), 'utf8'));
|
||||
|
||||
// DESIGN §1.1: 99 ascending cut points per stat. Cut k (1..99) is the value at rank floor(k·n/100)
|
||||
// of the sample's sorted scores; null attention is excluded from its table.
|
||||
function cuts(values) {
|
||||
const sorted = values.filter(v => typeof v === 'number').sort((a, b) => a - b);
|
||||
if (sorted.length < 2) throw new Error('sample too small');
|
||||
return Array.from({ length: 99 }, (_, i) => sorted[Math.min(sorted.length - 1, Math.floor((i + 1) * sorted.length / 100))]);
|
||||
}
|
||||
// Prefer council-data's published table (card-sample.json `percentiles`); fall back to computing it.
|
||||
const official = sample.percentiles && ['attention', 'depth', 'reach'].every(stat => sample.percentiles[stat]?.length === 99);
|
||||
const table = official ? { attention: sample.percentiles.attention, depth: sample.percentiles.depth, reach: sample.percentiles.reach }
|
||||
: Object.fromEntries(['attention', 'depth', 'reach'].map(stat => [stat, cuts(sample.cards.map(c => c.stats?.[stat]))]));
|
||||
const method = official ? sample.percentilesMethod : 'computed here: value at rank floor(k*n/100)';
|
||||
|
||||
const daysIn = month => { const [y, m] = month.split('-').map(Number); return new Date(Date.UTC(y, m, 0)).getUTCDate(); };
|
||||
const pool = starter.cards.map(c => ({
|
||||
pageId: c.pageId, title: c.title, category: c.category,
|
||||
stats: { attention: c.stats.attention ?? null, depth: c.stats.depth, reach: c.stats.reach },
|
||||
trendPercent: c.trendPercent ?? null,
|
||||
dailyAverage: typeof c.monthlyViews === 'number' && c.latestMonth ? Math.round(c.monthlyViews / daysIn(c.latestMonth) * 100) / 100 : null,
|
||||
}));
|
||||
|
||||
const out = `// GENERATED by scripts/game-card-data.mjs from docs/game/card-sample.json (${sample.cards.length} cards,
|
||||
// generated ${sample.generatedAt}) and docs/game/starter-cards.json (frozen ${starter.frozenAt}). Do not edit by hand.
|
||||
// Percentiles: ${method}
|
||||
import type { PercentileTable } from './derive.ts';
|
||||
import type { Faction } from './types.ts';
|
||||
|
||||
/** DESIGN §1.1 reference table "card-sample-2026-11-16": 99 cut points per stat. */
|
||||
export const CARD_SAMPLE_PERCENTILES: PercentileTable = ${JSON.stringify(table)};
|
||||
|
||||
export interface LoanerSnapshot {
|
||||
pageId: number; title: string; category: Faction;
|
||||
stats: { attention: number | null; depth: number; reach: number };
|
||||
trendPercent: number | null; dailyAverage: number | null;
|
||||
}
|
||||
|
||||
/** Frozen loaner pool (§2): real snapshots of random articles, for filling deck slots and draft modes. */
|
||||
export const LOANER_SNAPSHOTS: readonly LoanerSnapshot[] = ${JSON.stringify(pool, null, 1).replace(/\n\s*/g, ' ')};
|
||||
`;
|
||||
writeFileSync(new URL('shared/game/card-data.ts', root), out);
|
||||
console.log(`card-data.ts: ${pool.length} loaners, percentile tables from ${sample.cards.length} sample cards`);
|
||||
@@ -0,0 +1,42 @@
|
||||
#!/bin/bash
|
||||
# Build WikiDeck for the iOS simulator and launch it. Run INSIDE the macOS VM after Xcode is installed.
|
||||
# Usage: scripts/ios/build-sim.sh [simulator name, default "iPhone 16"]
|
||||
set -euo pipefail
|
||||
cd "$(dirname "$0")/../.."
|
||||
export PATH="$HOME/node/bin:$PATH"
|
||||
SIM="${1:-iPhone 16}"
|
||||
APP_ID=dev.eom.wikideck
|
||||
|
||||
xcode-select -p | grep -q Xcode.app || sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
|
||||
xcodebuild -version
|
||||
sudo xcodebuild -license accept 2>/dev/null || true
|
||||
xcodebuild -runFirstLaunch >/dev/null 2>&1 || true
|
||||
|
||||
npm ci
|
||||
# Same testnet build settings as android/build-debug.sh (otherwise the app shows MAINNET).
|
||||
export VITE_WIKIDECK_NETWORK="${VITE_WIKIDECK_NETWORK:-testnet}"
|
||||
export VITE_WIKIDECK_GENESIS_TIME="${VITE_WIKIDECK_GENESIS_TIME:-1792411200}"
|
||||
export VITE_NODE_URL="${VITE_NODE_URL:-http://192.168.1.32:3101}"
|
||||
npm run build
|
||||
npx cap sync ios
|
||||
|
||||
# Pick the simulator (fall back to the first available iPhone).
|
||||
UDID=$(xcrun simctl list devices available -j | python3 -c '
|
||||
import json,sys; want=sys.argv[1]; d=json.load(sys.stdin)["devices"]
|
||||
devs=[x for r,l in d.items() if "iOS" in r for x in l]
|
||||
m=[x for x in devs if x["name"]==want] or [x for x in devs if x["name"].startswith("iPhone")]
|
||||
print(m[-1]["udid"] if m else "")' "$SIM")
|
||||
[ -n "$UDID" ] || { echo "No iOS simulator runtime installed. Xcode > Settings > Components > iOS."; exit 1; }
|
||||
|
||||
xcodebuild -project ios/App/App.xcodeproj -scheme App -configuration Debug \
|
||||
-sdk iphonesimulator -destination "id=$UDID" -derivedDataPath ios/build \
|
||||
CODE_SIGNING_ALLOWED=NO build
|
||||
|
||||
APP=$(find ios/build/Build/Products/Debug-iphonesimulator -maxdepth 1 -name '*.app' | head -1)
|
||||
xcrun simctl boot "$UDID" 2>/dev/null || true
|
||||
open -a Simulator
|
||||
xcrun simctl install "$UDID" "$APP"
|
||||
xcrun simctl launch "$UDID" "$APP_ID"
|
||||
sleep 8
|
||||
xcrun simctl io "$UDID" screenshot "$HOME/wikideck-ios-sim.png"
|
||||
echo "Launched $APP_ID on $SIM ($UDID); screenshot: ~/wikideck-ios-sim.png"
|
||||
@@ -0,0 +1,156 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Summarise card-sample.json into markdown stats. Usage: python3 -I card_analyze.py sample.json > out.md"""
|
||||
import json, sys, math, statistics as st, collections, re
|
||||
d = json.load(open(sys.argv[1])); C = d['cards']
|
||||
def q(v):
|
||||
v = sorted(v); n = len(v)
|
||||
def p(x):
|
||||
k = (n - 1) * x; f = math.floor(k); c = min(f + 1, n - 1); return v[f] + (v[c] - v[f]) * (k - f)
|
||||
return [v[0], p(.1), p(.25), p(.5), p(.75), p(.9), v[-1]]
|
||||
def skew(v):
|
||||
m, s = st.mean(v), st.pstdev(v); return sum((x - m) ** 3 for x in v) / len(v) / s ** 3 if s else 0
|
||||
def rank(v):
|
||||
o = sorted(range(len(v)), key=lambda i: v[i]); r = [0] * len(v); i = 0
|
||||
while i < len(o):
|
||||
j = i
|
||||
while j + 1 < len(o) and v[o[j + 1]] == v[o[i]]: j += 1
|
||||
for k in range(i, j + 1): r[o[k]] = (i + j) / 2
|
||||
i = j + 1
|
||||
return r
|
||||
def pearson(a, b):
|
||||
ma, mb = st.mean(a), st.mean(b); sa = math.sqrt(sum((x - ma) ** 2 for x in a)); sb = math.sqrt(sum((y - mb) ** 2 for y in b))
|
||||
return sum((x - ma) * (y - mb) for x, y in zip(a, b)) / (sa * sb) if sa and sb else float('nan')
|
||||
pv = [c for c in C if c['pageviews']['status'] == 'available']
|
||||
F = {'attention': lambda c: c['stats']['attention'], 'depth': lambda c: c['stats']['depth'], 'reach': lambda c: c['stats']['reach'],
|
||||
'pageBytes': lambda c: c['pageBytes'], 'languageCount': lambda c: c['languageCount'],
|
||||
'monthlyViews': lambda c: c['pageviews']['months'][5]['views'] if c['pageviews']['status'] == 'available' else None,
|
||||
'dailyAverage': lambda c: c['pageviews']['dailyAverage'], 'trendPercent': lambda c: c['pageviews']['trendPercent'],
|
||||
'drift30Percent': lambda c: c['drift30']['pct']}
|
||||
out = []
|
||||
P = out.append
|
||||
rate = f"{len(C)/d['rawPagesSeen']*100:.0f}%" if d['rawPagesSeen'] else '~44% (149/340 logged during sampling)'
|
||||
P(f"Sample: **{len(C)} cards**; {rate} of random pages pass the illustrated filter. Pageviews available for {len(pv)}.\n")
|
||||
P('| stat | n | min | p10 | p25 | median | p75 | p90 | max | mean | skew |'); P('|---|---|---|---|---|---|---|---|---|---|---|')
|
||||
for k, f in F.items():
|
||||
v = [f(c) for c in C if f(c) is not None]
|
||||
qs = q(v); fmt = (lambda x: f'{x:.0f}') if k not in ('trendPercent', 'drift30Percent', 'dailyAverage') else (lambda x: f'{x:.1f}')
|
||||
P(f"| {k} | {len(v)} | " + ' | '.join(fmt(x) for x in qs) + f" | {fmt(st.mean(v))} | {skew(v):.2f} |")
|
||||
P('\n**Spearman rank correlations** (cards with pageviews):\n')
|
||||
keys = ['attention', 'depth', 'reach', 'trendPercent', 'drift30Percent']
|
||||
rows = [c for c in pv if c['pageviews']['trendPercent'] is not None and c['drift30']['pct'] is not None]
|
||||
R = {k: rank([F[k](c) for c in rows]) for k in keys}
|
||||
P('| | ' + ' | '.join(keys) + ' |'); P('|---' * (len(keys) + 1) + '|')
|
||||
for a in keys: P(f'| {a} | ' + ' | '.join(f'{pearson(R[a], R[b]):.2f}' for b in keys) + ' |')
|
||||
P(f'\n(n={len(rows)}; attention~monthlyViews, depth~pageBytes, reach~languageCount are monotonic so their rank correlations are identical.)\n')
|
||||
tp = [c['pageviews']['trendPercent'] for c in pv if c['pageviews']['trendPercent'] is not None]
|
||||
P(f"**trendPercent sign:** positive {sum(t>0 for t in tp)} ({sum(t>0 for t in tp)/len(tp)*100:.0f}%), negative {sum(t<0 for t in tp)} ({sum(t<0 for t in tp)/len(tp)*100:.0f}%), zero {sum(t==0 for t in tp)}; null (prior month 0 or no views) {len(C)-len(tp)}. "
|
||||
f"|trend| > 50%: {sum(abs(t)>50 for t in tp)}; > 100%: {sum(abs(t)>100 for t in tp)}.\n")
|
||||
dr = [c['drift30']['pct'] for c in C if c['drift30']['pct'] is not None]
|
||||
P(f"**30-day drift** (views 10-17..11-15 vs 09-17..10-16): median |drift| {st.median([abs(x) for x in dr]):.0f}%, "
|
||||
f"p90 |drift| {q([abs(x) for x in dr])[5]:.0f}%. Attention score change implied: "
|
||||
f"median {st.median([abs(100*math.log10((c['drift30']['last30']+1)/(c['drift30']['prev30']+1))/6) for c in C]):.1f} points, "
|
||||
f"p90 {q([abs(100*math.log10((c['drift30']['last30']+1)/(c['drift30']['prev30']+1))/6) for c in C])[5]:.1f} points.\n")
|
||||
for name, f in [('attention', F['attention']), ('depth', F['depth']), ('reach', F['reach'])]:
|
||||
v = [f(c) for c in C if f(c) is not None]; h = collections.Counter(min(x // 10, 9) for x in v)
|
||||
P(f"**{name} histogram (deciles 0-9,10-19..90-100):** " + ' '.join(str(h.get(i, 0)) for i in range(10)))
|
||||
P(f"\nReach = 0 (no other languages): {sum(c['languageCount']==0 for c in C)}; reach 100 (>=999 langs) impossible in practice, max langs {max(c['languageCount'] for c in C)}. "
|
||||
f"Attention null: {sum(c['stats']['attention'] is None for c in C)}; attention 0: {sum(c['stats']['attention']==0 for c in C)}.\n")
|
||||
s3 = [sum(F[k](c) or 0 for k in ('attention', 'depth', 'reach')) for c in C]
|
||||
P(f"**Sum of three stats:** " + ', '.join(f'{n} {x:.0f}' for n, x in zip(['min', 'p10', 'p25', 'median', 'p75', 'p90', 'max'], q(s3))) + '\n')
|
||||
P('**Legacy `category()` (server/wiki.ts):** ' + ', '.join(f'{k} {v}' for k, v in collections.Counter(c['legacyCategory'] for c in C).most_common()) + '\n')
|
||||
io = collections.Counter(x['label'] for c in C for x in c['instanceOf'])
|
||||
P('**Top Wikidata P31 classes:** ' + ', '.join(f'{k} {v}' for k, v in io.most_common(40)) + '\n')
|
||||
P(f"No Wikidata item: {sum(not c['wikidataId'] for c in C)}; no P31: {sum(not c['instanceOf'] for c in C)}\n")
|
||||
words = collections.Counter()
|
||||
for c in C:
|
||||
for cat in set(w for t in c['categories'] for w in re.findall(r'[a-z]+', t.lower()) if len(w) > 3): words[cat] += 1
|
||||
P('**Most frequent category words (cards containing):** ' + ', '.join(f'{k} {v}' for k, v in words.most_common(60)) + '\n')
|
||||
print('\n'.join(out))
|
||||
|
||||
# ---- rank normalisation table (critic request): score -> 1..10 tier by sample decile
|
||||
def tiers(name):
|
||||
v = sorted(F[name](c) for c in C if F[name](c) is not None)
|
||||
return [v[min(len(v) - 1, int(len(v) * k / 10))] for k in range(1, 10)]
|
||||
T = {k: tiers(k) for k in ('attention', 'depth', 'reach')}
|
||||
print('\n## Rank-normalised tiers (1–10)\n')
|
||||
print('Tier = 1 + number of breakpoints the score is **>=**. Breakpoints are the sample deciles p10..p90 of the 0–100 score. '
|
||||
'Ties make some tiers thin (scores are integers).\n')
|
||||
print('| stat | p10 | p20 | p30 | p40 | p50 | p60 | p70 | p80 | p90 |'); print('|---' * 10 + '|')
|
||||
for k, b in T.items(): print(f'| {k} | ' + ' | '.join(str(x) for x in b) + ' |')
|
||||
def tier(k, s): return None if s is None else 1 + sum(s >= x for x in T[k])
|
||||
for c in C: c['tiers'] = {k: tier(k, c['stats'][k]) for k in T}
|
||||
tc = collections.Counter(c['tiers']['attention'] for c in C)
|
||||
print('\nResulting tier counts — attention: ' + ' '.join(f'{t}:{tc.get(t,0)}' for t in [None] + list(range(1, 11))))
|
||||
for k in ('depth', 'reach'):
|
||||
tc = collections.Counter(c['tiers'][k] for c in C); print(f'; {k}: ' + ' '.join(f'{t}:{tc.get(t,0)}' for t in range(1, 11)))
|
||||
json.dump({'breakpoints': T, 'rule': 'tier = 1 + count(breakpoints <= score); attention null -> no tier'},
|
||||
open(sys.argv[2] if len(sys.argv) > 2 else '/dev/null', 'w'), indent=1)
|
||||
|
||||
# ---- starter loaner candidates: 4 per legacy category, spread over combined tier
|
||||
if len(sys.argv) > 3:
|
||||
pick = []
|
||||
for cat in ['Space', 'Nature', 'People', 'Science', 'History', 'Culture']:
|
||||
pool = sorted((c for c in C if c['legacyCategory'] == cat and c['stats']['attention'] is not None),
|
||||
key=lambda c: sum(c['tiers'].values()))
|
||||
if not pool: continue
|
||||
n = min(4, len(pool)); idx = sorted({round(i * (len(pool) - 1) / max(1, n - 1)) for i in range(n)})
|
||||
for i in idx:
|
||||
c = pool[i]
|
||||
pick.append({'pageId': c['pageId'], 'title': c['title'], 'category': cat, 'wikidataId': c['wikidataId'],
|
||||
'revisionId': c['revisionId'], 'pageBytes': c['pageBytes'], 'languageCount': c['languageCount'],
|
||||
'monthlyViews': c['pageviews']['months'][5]['views'], 'latestMonth': c['pageviews']['latestMonth'],
|
||||
'trendPercent': None if c['pageviews']['trendPercent'] is None else round(c['pageviews']['trendPercent'], 1),
|
||||
'stats': c['stats'], 'tiers': c['tiers']})
|
||||
json.dump({'frozenAt': d['generatedAt'][:10], 'note': 'Frozen loaner/starter stats from the council-data random sample. Do not fetch live.',
|
||||
'cards': pick}, open(sys.argv[3], 'w'), indent=1, ensure_ascii=False)
|
||||
print(f'\nStarter candidates: {len(pick)} written to {sys.argv[3]}: ' + collections.Counter(p['category'] for p in pick).__repr__())
|
||||
|
||||
# ---- candidate factions from Wikidata P31 (+ categories fallback)
|
||||
FAC = [
|
||||
('People', r'\bhuman\b|fictional character|person'),
|
||||
('Sport', r'season|sports team|football|match|tournament|championship|final\b|club|league|olympic|race\b'),
|
||||
('Nature', r'taxon|species|genus|plant|fungus|disease|epiphyte|mineral|bird|fish|insect'),
|
||||
('Places', r'village|town|city|commune|municipality|river|lake|mountain|county|district|parish|region|plateau|island|settlement|neighbo|locality|census|hamlet|valley|bay|area|province|state of|capital|suburb|stream|peak|unincorporated|human settlement|local government'),
|
||||
('Structures', r'building|castle|mosque|church|cathedral|temple|bridge|station|railway line|road|highway|museum|structure|stadium|dam|tower|house|school|hospital|airport|monument|fort|palace|lighthouse|park'),
|
||||
('Works', r'film|album|single|song|musical|television|book|novel|video game|painting|literary|composition|series|episode|magazine|newspaper|poem|opera|play\b|artwork|sculpture'),
|
||||
('Organisations', r'company|group|band|organi[sz]ation|university|college|party|business|enterprise|agency|institute|association|brand|union|ministry|military unit'),
|
||||
('Events', r'election|protest|battle|war\b|storm|nor.easter|cyclone|event|disaster|treaty|conflict|earthquake|incident|festival|referendum|conference|ceremony'),
|
||||
('Ideas & Tech', r'programming|software|language|chemical|compound|gene|protein|theorem|concept|technology|vehicle|aircraft|ship|weapon|class|model|device|algorithm|religion|discipline|theory|food|dish'),
|
||||
]
|
||||
def faction(c):
|
||||
text = ' | '.join(x['label'].lower() for x in c['instanceOf'])
|
||||
for name, rx in FAC:
|
||||
if text and re.search(rx, text): return name
|
||||
cats = ' | '.join(c['categories']).lower()
|
||||
if re.search(r'births|deaths|people', cats): return 'People'
|
||||
if re.search(r'populated|villages|towns|geography|rivers', cats): return 'Places'
|
||||
if re.search(r'films|albums|songs|novels|television|video games', cats): return 'Works'
|
||||
return 'Other'
|
||||
for c in C: c['faction'] = faction(c)
|
||||
print('\n## Candidate factions (Wikidata P31 rules)\n')
|
||||
print('| faction | n | share | median attention | median depth | median reach | example |'); print('|---|---|---|---|---|---|---|')
|
||||
by = collections.defaultdict(list)
|
||||
for c in C: by[c['faction']].append(c)
|
||||
for name, cs in sorted(by.items(), key=lambda kv: -len(kv[1])):
|
||||
med = lambda k: st.median([x['stats'][k] for x in cs if x['stats'][k] is not None] or [0])
|
||||
print(f"| {name} | {len(cs)} | {len(cs)/len(C)*100:.0f}% | {med('attention'):.0f} | {med('depth'):.0f} | {med('reach'):.0f} | {cs[0]['title']} |")
|
||||
other = collections.Counter(x['label'] for c in by.get('Other', []) for x in c['instanceOf'])
|
||||
print('\nUnclassified P31 labels: ' + ', '.join(f'{k} {v}' for k, v in other.most_common(25)))
|
||||
if len(sys.argv) > 4: json.dump({c['pageId']: c['faction'] for c in C}, open(sys.argv[4], 'w'))
|
||||
if len(sys.argv) > 3:
|
||||
s = json.load(open(sys.argv[3])); fmap = {c['pageId']: c['faction'] for c in C}
|
||||
for p in s['cards']: p['faction'] = fmap[p['pageId']]
|
||||
json.dump(s, open(sys.argv[3], 'w'), indent=1, ensure_ascii=False)
|
||||
if len(sys.argv) > 5:
|
||||
d['factionRules'] = [[n, rx] for n, rx in FAC]; d['tierBreakpoints'] = T
|
||||
def cuts(k):
|
||||
v = sorted(c['stats'][k] for c in C if c['stats'][k] is not None); n = len(v)
|
||||
return [v[max(0, math.ceil(i * n / 100) - 1)] for i in range(1, 100)]
|
||||
d['percentiles'] = {k: cuts(k) for k in ('attention', 'depth', 'reach')}
|
||||
d['percentilesMethod'] = 'cut point i (1..99) = nearest-rank i-th percentile of the sample snapshot score (sorted ascending, index ceil(i*n/100)-1). Use with DESIGN.md §1.1 counting.'
|
||||
if not d['rawPagesSeen']:
|
||||
d['randomBatches'], d['rawPagesSeen'] = 17, 340
|
||||
d['randomBatchesNote'] = 'Sampling was resumed from a saved state, so full batch counts were lost. These are the counts logged at batch 17 (149 illustrated of 340 raw pages, 44% pass rate). The 330 picked cards came from about 38 batches; this sample holds the first N of those that finished enrichment before sampling stopped (Wikimedia 429s).'
|
||||
d['note'] = 'docs/game/starter-cards.json is the loaner POOL (real frozen snapshots of random articles), used by the sim and the deck builder to fill slots. The default starter decks are defined in DESIGN.md §2.1; their real pageIds are in starter-cards.json under starterDeckPageIds.'
|
||||
for c in d['cards']: c['category'] = c['legacyCategory']
|
||||
json.dump(d, open(sys.argv[5], 'w'), indent=1, ensure_ascii=False)
|
||||
@@ -0,0 +1,158 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Sample random illustrated en.wikipedia articles the way server/wiki.ts selects them and
|
||||
enrich them the way server/enrichment.ts does. Polite: ~4 req/s, sequential, disk cache.
|
||||
Usage: python3 -I card_sample.py <cache_dir> <out.json> [target=320]"""
|
||||
import hashlib, json, os, re, sys, time, urllib.parse, urllib.request, calendar, datetime as dt
|
||||
|
||||
UA = 'WikiDeckCardDataSampler/0.1 (experimental card-game stat research; python-urllib)'
|
||||
CACHE, OUT = sys.argv[1], sys.argv[2]
|
||||
TARGET = int(sys.argv[3]) if len(sys.argv) > 3 else 320
|
||||
os.makedirs(CACHE, exist_ok=True)
|
||||
_last = [0.0]
|
||||
|
||||
def get(url, cache=True):
|
||||
key = os.path.join(CACHE, hashlib.sha1(url.encode()).hexdigest() + '.json')
|
||||
if cache and os.path.exists(key):
|
||||
return json.load(open(key))
|
||||
if os.environ.get('CACHE_ONLY') and 'wikidata.org' not in url:
|
||||
return {'__missing': True}
|
||||
for attempt in range(6):
|
||||
wait = 1.0 - (time.time() - _last[0])
|
||||
if wait > 0: time.sleep(wait)
|
||||
_last[0] = time.time()
|
||||
req = urllib.request.Request(url, headers={'User-Agent': UA, 'Accept': 'application/json'})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=20) as r:
|
||||
data = json.loads(r.read().decode())
|
||||
break
|
||||
except urllib.error.HTTPError as e:
|
||||
if e.code == 404: data = {'__404': True}; break
|
||||
if e.code == 429 or e.code >= 500:
|
||||
ra = e.headers.get('retry-after'); w = int(ra) + 1 if ra and ra.isdigit() else 5 * (attempt + 1)
|
||||
print('http', e.code, 'sleep', w, file=sys.stderr); time.sleep(min(w, 60)); continue
|
||||
raise
|
||||
except Exception as e:
|
||||
print('retry', attempt, type(e).__name__, e, file=sys.stderr); time.sleep(2 * (attempt + 1))
|
||||
else:
|
||||
raise RuntimeError('failed ' + url)
|
||||
if cache: json.dump(data, open(key, 'w'))
|
||||
return data
|
||||
|
||||
def api(params, cache=True):
|
||||
return get('https://en.wikipedia.org/w/api.php?' + urllib.parse.urlencode({'format': 'json', 'formatversion': '2', **params}), cache)
|
||||
|
||||
def legacy_category(title, cats):
|
||||
t = (title + ' ' + ' '.join(cats)).lower()
|
||||
if re.search(r'astronom|planet|space|galax|moon|star\b', t): return 'Space'
|
||||
if re.search(r'animal|plant|species|ocean|biolog|mollusc', t): return 'Nature'
|
||||
if re.search(r'births|deaths|people|scientist', t): return 'People'
|
||||
if re.search(r'physic|chem|math|science|technolog', t): return 'Science'
|
||||
if re.search(r'histor|ancient|archaeolog|empire', t): return 'History'
|
||||
return 'Culture'
|
||||
|
||||
def score(v, scale):
|
||||
import math
|
||||
return min(100, round(math.log10(v + 1) / scale * 100))
|
||||
|
||||
# 1. random illustrated articles (same filter as wiki.ts: thumbnail + extract >= 40 chars)
|
||||
picked, seen, batches, raw_pages = [], set(), 0, 0
|
||||
state_file = os.path.join(CACHE, '_random_state.json')
|
||||
if os.path.exists(state_file):
|
||||
picked = json.load(open(state_file)); seen = {p['pageId'] for p in picked}
|
||||
while len(picked) < TARGET:
|
||||
try: d = api({'action': 'query', 'generator': 'random', 'grnnamespace': '0', 'grnlimit': '20',
|
||||
'prop': 'extracts|pageimages|info|categories', 'exintro': '1', 'explaintext': '1', 'exchars': '900',
|
||||
'exlimit': '20', 'piprop': 'thumbnail', 'pithumbsize': '800', 'cllimit': '500'}, cache=False)
|
||||
except RuntimeError as e: print(e, file=sys.stderr); time.sleep(5); continue
|
||||
batches += 1
|
||||
for p in d.get('query', {}).get('pages', []):
|
||||
raw_pages += 1
|
||||
thumb = (p.get('thumbnail') or {}).get('source', '')
|
||||
ext = (p.get('extract') or '').strip()
|
||||
if not re.match(r'https://(upload|thumb)\.wikimedia\.org/', thumb) or len(ext) < 40 or p['pageid'] in seen: continue
|
||||
seen.add(p['pageid'])
|
||||
picked.append({'pageId': p['pageid'], 'title': p['title'],
|
||||
'legacyCategory': legacy_category(p['title'], [c['title'] for c in p.get('categories', [])])})
|
||||
json.dump(picked, open(state_file, 'w'))
|
||||
print(f'random batch {batches}: {len(picked)} illustrated / {raw_pages} raw', file=sys.stderr)
|
||||
picked = picked[:TARGET]
|
||||
|
||||
# 2. enrichment per article (same params as enrichment.ts) + daily views for drift
|
||||
now = dt.datetime(2026, 11, 16, tzinfo=dt.timezone.utc)
|
||||
months = []
|
||||
for i in range(6):
|
||||
m = now.month - 6 + i; y = now.year + (m - 1) // 12; m = (m - 1) % 12 + 1
|
||||
months.append(f'{y:04d}-{m:02d}')
|
||||
# batched metadata (same props as enrichment.ts; per-page cllimit 50 is emulated by truncating)
|
||||
meta = {}
|
||||
ids = [p['pageId'] for p in picked]
|
||||
for i in range(0, len(ids), 50):
|
||||
chunk = ids[i:i + 50]; cont = {}; pages = {}
|
||||
while True:
|
||||
md = api({'action': 'query', 'pageids': '|'.join(map(str, chunk)), 'prop': 'info|categories|pageprops|description|langlinks',
|
||||
'clshow': '!hidden', 'cllimit': '500', 'lllimit': '500', 'ppprop': 'wikibase_item', **cont})
|
||||
for pg in md['query']['pages']:
|
||||
cur = pages.setdefault(pg['pageid'], {**pg, 'categories': [], 'langlinks': []})
|
||||
cur['categories'] += pg.get('categories', []); cur['langlinks'] += pg.get('langlinks', [])
|
||||
if 'continue' not in md: break
|
||||
cont = md['continue']
|
||||
meta.update(pages)
|
||||
print(f'metadata {len(meta)}/{len(ids)}', file=sys.stderr)
|
||||
cards = []
|
||||
for n, pk in enumerate(picked):
|
||||
page = meta[pk['pageId']]
|
||||
cont = {'clcontinue': 1} if len(page['categories']) > 50 else {}
|
||||
page['categories'] = page['categories'][:50]
|
||||
langs = len(page.get('langlinks', []))
|
||||
t = urllib.parse.quote(page['title'].replace(' ', '_'), safe='')
|
||||
daily = get(f'https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/en.wikipedia.org/all-access/user/{t}/daily/{months[0].replace("-", "")}01/20261115')
|
||||
if daily.get('__missing'): continue
|
||||
dmap = {it['timestamp'][:8]: it['views'] for it in daily.get('items', [])}
|
||||
pv = {'status': 'unavailable', 'months': [], 'latestMonth': months[5], 'total': None, 'dailyAverage': None, 'trendPercent': None}
|
||||
if dmap:
|
||||
ordered = []
|
||||
for m in months:
|
||||
y, mo = map(int, m.split('-')); nd = calendar.monthrange(y, mo)[1]
|
||||
ordered.append({'month': m, 'views': sum(dmap.get(f'{y:04d}{mo:02d}{d:02d}', 0) for d in range(1, nd + 1))})
|
||||
latest, prior = ordered[5]['views'], ordered[4]['views']
|
||||
nd = calendar.monthrange(*map(int, months[5].split('-')))[1]
|
||||
pv = {'status': 'available', 'months': ordered, 'latestMonth': months[5], 'total': sum(o['views'] for o in ordered),
|
||||
'dailyAverage': latest / nd, 'trendPercent': (latest - prior) / prior * 100 if prior > 0 else None}
|
||||
# 30-day drift: views 2026-10-17..11-15 vs 2026-09-17..10-16
|
||||
def window(start, days):
|
||||
s = dt.date.fromisoformat(start)
|
||||
return sum(dmap.get((s + dt.timedelta(d)).strftime('%Y%m%d'), 0) for d in range(days))
|
||||
last30, prev30 = window('2026-10-17', 30), window('2026-09-17', 30)
|
||||
pb = page['length']
|
||||
cards.append({'pageId': page['pageid'], 'title': page['title'], 'description': page.get('description'),
|
||||
'wikidataId': (page.get('pageprops') or {}).get('wikibase_item'), 'revisionId': page['lastrevid'], 'pageBytes': pb,
|
||||
'languageCount': langs, 'languagesTruncated': 'llcontinue' in cont,
|
||||
'categories': [c['title'].removeprefix('Category:') for c in page.get('categories', [])],
|
||||
'categoriesTruncated': 'clcontinue' in cont, 'fetchedAt': now.isoformat(), 'pageviews': pv,
|
||||
'stats': {'attention': score(pv['months'][5]['views'], 6) if pv['status'] == 'available' else None,
|
||||
'depth': score(pb, 6), 'reach': score(langs, 3)},
|
||||
'legacyCategory': pk['legacyCategory'],
|
||||
'drift30': {'last30': last30, 'prev30': prev30, 'pct': (last30 - prev30) / prev30 * 100 if prev30 else None}})
|
||||
if n % 25 == 0: print(f'enriched {n + 1}/{len(picked)}', file=sys.stderr)
|
||||
|
||||
# 3. Wikidata P31 (instance of) + labels
|
||||
qids = [c['wikidataId'] for c in cards if c['wikidataId']]
|
||||
p31 = {}
|
||||
for i in range(0, len(qids), 50):
|
||||
d = get('https://www.wikidata.org/w/api.php?' + urllib.parse.urlencode({'action': 'wbgetentities', 'format': 'json',
|
||||
'ids': '|'.join(qids[i:i + 50]), 'props': 'claims'}))
|
||||
for q, ent in d.get('entities', {}).items():
|
||||
p31[q] = [c['mainsnak']['datavalue']['value']['id'] for c in ent.get('claims', {}).get('P31', [])
|
||||
if c['mainsnak'].get('datavalue')]
|
||||
classes = sorted({c for v in p31.values() for c in v})
|
||||
labels = {}
|
||||
for i in range(0, len(classes), 50):
|
||||
d = get('https://www.wikidata.org/w/api.php?' + urllib.parse.urlencode({'action': 'wbgetentities', 'format': 'json',
|
||||
'ids': '|'.join(classes[i:i + 50]), 'props': 'labels', 'languages': 'en'}))
|
||||
for q, ent in d.get('entities', {}).items():
|
||||
labels[q] = ent.get('labels', {}).get('en', {}).get('value', q)
|
||||
for c in cards:
|
||||
c['instanceOf'] = [{'id': q, 'label': labels.get(q, q)} for q in p31.get(c['wikidataId'], [])]
|
||||
json.dump({'generatedAt': dt.datetime.now(dt.timezone.utc).isoformat(), 'method': 'random ns0 batches of 20, filter as server/wiki.ts (thumbnail + extract>=40); enrichment as server/enrichment.ts; monthly views summed from daily REST pageviews; P31 from Wikidata',
|
||||
'randomBatches': batches, 'rawPagesSeen': raw_pages, 'cards': cards}, open(OUT, 'w'), indent=1, ensure_ascii=False)
|
||||
print('done', len(cards), file=sys.stderr)
|
||||
@@ -0,0 +1,85 @@
|
||||
// Sim card pool from council-data's docs/game/card-sample.json (or starter-cards.json),
|
||||
// derived per DESIGN §1 (percentile -> fame -> cost, home stat) and §10.1 (faction keyword).
|
||||
// Percentile cut points come from the file itself. Power is (re)set from the ruleset by the adapter.
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { KEYWORD_IDS, type GameCard, type Stat } from '../../shared/game/index.ts';
|
||||
import { mulberry32 } from '../../shared/bots/index.ts';
|
||||
import type { DeckSpec } from '../../shared/bots/types.ts';
|
||||
|
||||
const STATS: Stat[] = ['attention', 'depth', 'reach'];
|
||||
const HOME_TIE: Stat[] = ['depth', 'reach', 'attention'];
|
||||
/** DESIGN v1 §10.2 (PR #17): one keyword per faction. */
|
||||
export const FACTION_KEYWORD: Record<string, string> = {
|
||||
Culture: 'viral', Nature: 'rising', People: 'local', Science: 'encyclopedic', History: 'nostalgic', Space: 'translated',
|
||||
};
|
||||
|
||||
interface RawCard { pageId: number; title: string; category?: string; legacyCategory?: string; stats: Record<Stat, number | null>; trendPercent?: number; pageviews?: { trendPercent?: number | null; dailyAverage?: number | null } }
|
||||
|
||||
function cuts(values: number[]): number[] {
|
||||
const s = [...values].sort((a, b) => a - b);
|
||||
return Array.from({ length: 99 }, (_, i) => s[Math.min(s.length - 1, Math.floor(((i + 1) / 100) * s.length))]);
|
||||
}
|
||||
function percentile(score: number, c: number[]): number {
|
||||
let below = 0, equal = 0;
|
||||
for (const x of c) { if (x < score) below++; else if (x === score) equal++; }
|
||||
return Math.floor(below + equal / 2);
|
||||
}
|
||||
|
||||
export interface PoolOptions { costThresholds?: number[]; keywords?: 'faction' | 'none'; table?: string; /** v1.1 proposal: Culture takes its home-stat keyword. */ cultureKeyword?: 'faction' | 'home' }
|
||||
const CULTURE_HOME: Record<Stat, string> = { attention: 'viral', depth: 'encyclopedic', reach: 'translated' };
|
||||
|
||||
export function loadPool(file: string, opts: PoolOptions = {}): GameCard[] {
|
||||
const raw = JSON.parse(readFileSync(file, 'utf8')).cards as RawCard[];
|
||||
const tableRaw = opts.table ? (JSON.parse(readFileSync(opts.table, 'utf8')).cards as RawCard[]) : raw;
|
||||
const table = Object.fromEntries(STATS.map(s => [s, cuts(tableRaw.map(c => c.stats[s]).filter((v): v is number => v !== null))])) as Record<Stat, number[]>;
|
||||
const thresholds = opts.costThresholds ?? [15, 35, 55, 75, 90];
|
||||
return raw.map(c => {
|
||||
const pct = Object.fromEntries(STATS.map(s => [s, c.stats[s] === null ? null : percentile(c.stats[s]!, table[s])])) as Record<Stat, number | null>;
|
||||
const vals = STATS.map(s => pct[s]).filter((v): v is number => v !== null);
|
||||
const fame = Math.floor(vals.reduce((a, b) => a + b, 0) / vals.length + 0.5);
|
||||
const cost = 1 + thresholds.filter(t => t <= fame).length;
|
||||
let home: Stat = HOME_TIE[0];
|
||||
for (const s of HOME_TIE) { const v = pct[s], cur = pct[home]; if (v !== null && (cur === null || v > cur)) home = s; }
|
||||
const faction = (c.category ?? c.legacyCategory ?? 'Culture') as GameCard['faction'];
|
||||
const kw = faction === 'Culture' && opts.cultureKeyword === 'home' ? CULTURE_HOME[home] : FACTION_KEYWORD[faction];
|
||||
const keyword = cost === 1 || opts.keywords === 'none' || !kw || !(KEYWORD_IDS as readonly string[]).includes(kw) ? null : kw;
|
||||
return {
|
||||
cardId: `loaner:${c.pageId}`, pageId: c.pageId, title: c.title, faction, rarity: 'Common', cost, power: 0,
|
||||
home, trend: 0, keyword, source: 'loaner',
|
||||
} satisfies GameCard;
|
||||
});
|
||||
}
|
||||
|
||||
const kebab = (t: string) => t.toLowerCase().normalize('NFKD').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
|
||||
|
||||
/** The DESIGN §2.1 starter decks: "**A. Name: ...**" headings followed by | Cost | Card | Faction | Home | tables. */
|
||||
export function loadStarterDecks(designMd: string): DeckSpec[] {
|
||||
const text = readFileSync(designMd, 'utf8');
|
||||
const sec = text.slice(text.indexOf('### 2.1'), text.indexOf('## 3.'));
|
||||
const decks: DeckSpec[] = [];
|
||||
let cur: { id: string; cards: GameCard[] } | null = null;
|
||||
for (const line of sec.split('\n')) {
|
||||
const h = line.match(/^\*\*([A-Z])\. ([^:*]+)/);
|
||||
if (h) { cur = { id: `starter-${h[1]}-${kebab(h[2])}`, cards: [] }; decks.push({ id: cur.id, tags: ['arch:starter-v1'], payload: cur.cards }); continue; }
|
||||
const r = line.match(/^\| (\d) \| ([^|]+) \| (\w+) \| (\w+) \|$/);
|
||||
if (r && cur) {
|
||||
const [, cost, title, faction, home] = r;
|
||||
const c = Number(cost), kw = FACTION_KEYWORD[faction];
|
||||
cur.cards.push({
|
||||
cardId: `loaner:${kebab(title.trim())}`, pageId: null, title: title.trim(), faction: faction as GameCard['faction'], rarity: 'Common',
|
||||
cost: c, power: 0, home: home as Stat, trend: 0, keyword: c === 1 || !(KEYWORD_IDS as readonly string[]).includes(kw) ? null : kw, source: 'loaner',
|
||||
});
|
||||
}
|
||||
}
|
||||
return decks.filter(d => (d.payload as GameCard[]).length === 12);
|
||||
}
|
||||
|
||||
/** "Realistic owned" decks (DESIGN §2.1 v1.1 note): `n` seeded draws of 12 distinct cards from the pool, real category mix. */
|
||||
export function ownedDecks(pool: GameCard[], n: number, size = 12, seed = 7): DeckSpec[] {
|
||||
const rng = mulberry32(seed);
|
||||
return Array.from({ length: n }, (_, i) => {
|
||||
const p = [...pool];
|
||||
for (let k = p.length - 1; k > 0; k--) { const j = Math.floor(rng() * (k + 1)); [p[k], p[j]] = [p[j], p[k]]; }
|
||||
return { id: `owned-${i}`, tags: ['arch:owned-random'], payload: p.slice(0, size).map(c => ({ ...c, cardId: `${c.cardId}:0` })) };
|
||||
});
|
||||
}
|
||||