@mpgd/cli 0.13.0 → 0.15.0

package/templates/phaser-game/apps/target-ait/src/styles.css

@@ -0,0 +1,33 @@
+html,
+body,
+#app {
+  width: 100%;
+  height: 100%;
+  margin: 0;
+}
+
+body {
+  background: #101820;
+  color: #f8fafc;
+  font-family:
+    Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+}
+
+.shell {
+  min-height: 100%;
+  display: grid;
+  place-content: center;
+  gap: 12px;
+  padding: 24px;
+  box-sizing: border-box;
+  text-align: center;
+}
+
+h1,
+p {
+  margin: 0;
+}
+
+code {
+  color: #fff7ad;
+}

package/templates/phaser-game/apps/target-ait/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "types": ["vite/client", "node"],
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts", "vite.config.ts", "granite.config.ts"]
+}

package/templates/phaser-game/apps/target-ait/vite.config.ts

@@ -0,0 +1,53 @@
+import { readFileSync } from 'node:fs';
+
+import aitDevtools from '@ait-co/devtools/unplugin';
+import { extractAitAdBridgeConfig } from '@mpgd/adapter-ait/ad-config';
+import ttsc from '@ttsc/unplugin/vite';
+import { defineConfig } from 'vite';
+
+const isTruthyEnv = (value: string | undefined): boolean =>
+  value !== undefined && value !== '' && value !== '0' && value.toLowerCase() !== 'false';
+const aitDevtoolsTunnel = isTruthyEnv(process.env.AIT_TUNNEL)
+  ? { cdp: isTruthyEnv(process.env.AIT_TUNNEL_CDP) }
+  : false;
+const aitAppName = process.env.MPGD_AIT_APP_NAME?.trim() || '__GAME_NAME__';
+const aitAdConfig = readAitAdConfig(process.env.MPGD_AD_PLACEMENTS_FILE);
+
+export default defineConfig(({ command, isPreview }) => ({
+  define: {
+    __MPGD_AIT_APP_NAME__: JSON.stringify(aitAppName),
+    __MPGD_AIT_AD_GROUP_IDS__: JSON.stringify(aitAdConfig.adGroupIds),
+    __MPGD_AIT_AD_PLACEMENT_TYPES__: JSON.stringify(aitAdConfig.adPlacementTypes),
+  },
+  plugins: [
+    ...(command === 'serve' && !isPreview && process.env.MPGD_AIT_DEVTOOLS !== '0'
+      ? [aitDevtools.vite({ mcp: true, tunnel: aitDevtoolsTunnel })]
+      : []),
+    ttsc({ project: 'tsconfig.json', plugins: false }),
+  ],
+  build: {
+    target: 'es2022',
+    outDir: 'dist',
+    emptyOutDir: true,
+  },
+}));
+
+function readAitAdConfig(path: string | undefined): {
+  readonly adGroupIds: Readonly<Record<string, string>>;
+  readonly adPlacementTypes: Readonly<Record<string, 'rewarded' | 'interstitial'>>;
+} {
+  if (path === undefined || path.trim().length === 0) {
+    return { adGroupIds: {}, adPlacementTypes: {} };
+  }
+
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(readFileSync(path, 'utf8')) as unknown;
+  } catch (error) {
+    throw new Error(`AIT ad placements file is unreadable or invalid JSON: ${path}`, {
+      cause: error,
+    });
+  }
+
+  return extractAitAdBridgeConfig(parsed, path);
+}

package/templates/phaser-game/docs/MPGD_KIT_WORKFLOWS.md

@@ -0,0 +1,128 @@
+# mpgd-kit workflows
+
+This guide is the capability map for this generated game. Start with
+`agent/game-manifest.json`: configured targets are available now; `futureTargets`
+are design directions, not implemented release paths.
+
+## Core boundaries
+
+| Concern | Owner |
+| --- | --- |
+| Deterministic rules and state | `src/game` and simulation modules |
+| Rendering and input | `src/scenes` |
+| Platform selection and services | `src/platform` through `PlatformGateway` |
+| Target build ownership | `mpgd.targets.json` |
+| Runtime/effective configuration | `@mpgd/target-config` and target config files |
+| Agent capability and acceptance contract | `agent/` |
+
+Do not import platform SDKs into scenes or pure game logic. Add a capability to
+`PlatformGateway`, implement it behind an adapter or wrapper, and provide a
+capability-disabled fallback where the target cannot support it.
+
+## Shared game capabilities
+
+### Assets and icons
+
+- Keep Phaser-loadable assets in the game-owned asset manifest.
+- Replace starter icons, then run `pnpm icons:generate`, `pnpm icons:verify`,
+  and optionally `pnpm icons:inspect`.
+- Use target icon profiles from `mpgd.targets.json`; do not maintain unrelated
+  hand-copied icon sets.
+
+### Localization and orientation
+
+- Add game text through the generated i18n messages and resolve locale from the
+  effective target configuration.
+- Choose a responsive, preferred, or soft-lock orientation policy before
+  building resize and rotate-prompt behavior. Keep the installed web manifest
+  orientation aligned with the runtime policy.
+
+### Analytics, saves, commerce, ads, and leaderboards
+
+- Emit best-effort analytics through `@mpgd/analytics`; never depend on a debug
+  or analytics side effect for game correctness.
+- Route identity, saves, lifecycle, host presentation, commerce, ads, and
+  leaderboards through `PlatformGateway`.
+- Use `@mpgd/game-services` and a game-owned backend for purchase ledgers,
+  rewarded-ad grants, entitlements, and verified leaderboard records. Client
+  success callbacks are requests or pending evidence, never grant authority.
+
+## Build and acceptance loop
+
+Use `MPGD_KIT_PATH` or pass `--kit-path` to a nearby kit checkout.
+
+```sh
+pnpm check
+pnpm build
+pnpm icons:verify
+pnpm exec mpgd target doctor --targets-file ./mpgd.targets.json --kit-path ../mpgd-kit --targets default
+pnpm exec mpgd target build-all --targets-file ./mpgd.targets.json --kit-path ../mpgd-kit --targets default --profile staging --ait-variant wrapper
+pnpm exec mpgd target smoke-all --targets-file ./mpgd.targets.json --kit-path ../mpgd-kit --targets default
+pnpm accept
+```
+
+`pnpm accept` records checks, build, graph preflight, optional browser playtest,
+target build/smoke, and optional gameplay E2E results under
+`artifacts/acceptance`. Add a game-owned `playtest` or `gameplay:e2e` driver
+when the release needs stronger browser or state-path evidence.
+
+## Target routing
+
+### Browser preview
+
+Use the browser adapter for local and hosted web behavior. Verify installed-PWA
+updates without forcing service-worker activation while old windows remain
+open.
+
+### Microsoft Store
+
+This target is optional. Enable it in an existing generated game with:
+
+```sh
+pnpm exec mpgd target init microsoft-store --game . --kit-path ../mpgd-kit
+```
+
+The initializer adds the target, scripts, PWA runtime hook, Store config, and
+`.agents/skills/release-microsoft-store/SKILL.md` without overwriting conflicts.
+Use that skill for the complete release and evidence sequence.
+
+### Verse8
+
+Build through the Verse8 adapter. Keep host credentials and authenticated cloud
+state behind target services. Treat client commerce as pending; authoritative
+grants belong in a game-owned Agent8 server purchase event with consume-once
+catalog handling and verified completion logic for leaderboards.
+
+### Apps in Toss
+
+Use official Apps in Toss documentation/MCP before SDK or review-flow changes.
+Keep SDK imports in the wrapper/adapter, declare permission-gated Web APIs in
+the game-owned config, and create a game-owned production wrapper instead of
+shipping the kit reference wrapper.
+
+### Reddit Devvit
+
+Keep the app in `apps/target-devvit`, use official Devvit documentation/MCP,
+and keep SDK calls behind the adapter or wrapper. Preserve separate lightweight
+inline and expanded game modes, avoid trapping feed scroll, and validate login,
+init, upload, and playtest with the generated scripts.
+
+### Android and iOS
+
+Use a game-owned Capacitor shell for production. Keep native plugin imports in
+the shell, adapters, or native plugins; configure signing outside source
+control. Validate the web game and effective target config before native store
+packaging.
+
+### Future targets
+
+For Telegram, Tauri, or another platform, first add a target-config entry and
+adapter behind `PlatformGateway`, then add build, smoke, agent manifest, and
+acceptance coverage. Do not let a new SDK leak into existing game logic.
+
+## Handoff evidence
+
+Keep source revision, config, build/smoke results, gameplay evidence, target
+preflight, artifact hashes, and target acceptance reports together. A generic
+kit smoke test proves the reusable contract only; it does not replace
+game-owned production credentials, deployment, signing, or store evidence.

package/templates/phaser-game/gitignore

@@ -1,8 +1,15 @@
 node_modules/
 dist/
 apps/*/dist/
+apps/target-ait/.ait_relay
+apps/target-ait/.ait_urls
+apps/target-ait/.granite/
+apps/target-ait/generated/
+apps/target-ait/public/assets/
+apps/target-ait/public/game/
 apps/target-devvit/generated/
 artifacts/
+release-input/
 release-output/
 .mpgd.targets.generated.json
 .mpgd/

package/templates/phaser-game/mpgd.microsoft-store.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": 1,
+  "productIdentity": {
+    "packageId": "REPLACE_ME",
+    "publisherId": "CN=REPLACE_ME",
+    "publisherDisplayName": "REPLACE_ME",
+    "reservedName": "REPLACE_ME"
+  },
+  "listing": {
+    "category": "Games",
+    "supportUrl": "https://example.com/support",
+    "personalData": {
+      "accessedOrTransmitted": true,
+      "privacyPolicyUrl": "https://example.com/privacy"
+    },
+    "locales": {
+      "en-US": {
+        "description": "REPLACE_ME",
+        "screenshots": ["store-assets/en-US/01.png"]
+      }
+    }
+  },
+  "ageRating": {
+    "questionnaireCompleted": false
+  },
+  "commerce": {
+    "mode": "disabled"
+  }
+}

package/templates/phaser-game/mpgd.targets.json

@@ -42,10 +42,17 @@
     "ait": {
       "kind": "apps-in-toss",
       "gameApp": ".",
-      "wrapperApp": "${MPGD_KIT_PATH}/apps/target-ait",
+      "wrapperApp": "apps/target-ait",
       "adapter": "ait",
+      "authoritativeGameServices": false,
+      "metadata": {
+        "appName": "__GAME_NAME__",
+        "displayName": "__GAME_TITLE__",
+        "primaryColor": "#101820",
+        "sdkMajor": 2
+      },
       "icon": { "profile": "ait" },
-      "webDir": "${MPGD_KIT_PATH}/apps/target-ait/public/game",
+      "webDir": "apps/target-ait/public/game",
       "artifact": ".ait"
     },
     "reddit": {

package/templates/phaser-game/package.json

@@ -6,7 +6,7 @@
   "type": "module",
   "scripts": {
     "dev": "__WORKSPACE_I18N_BUILD_PREFIX__vite --host 0.0.0.0",
-    "dev:ait": "APP_TARGET=ait APP_VERSION=0.0.0-dev BUILD_ID=ait-sandbox sh -c '__WORKSPACE_I18N_BUILD_PREFIX__vite --host 0.0.0.0'",
+    "dev:ait": "APP_TARGET=ait MPGD_CONFIG_TARGET=ait MPGD_PLATFORM_TARGETS_FILE=./mpgd.targets.json APP_VERSION=0.0.0-dev BUILD_ID=ait-sandbox sh -c '__WORKSPACE_I18N_BUILD_PREFIX__vite --host 0.0.0.0'",
     "build": "__WORKSPACE_I18N_BUILD_PREFIX__vite build",
     "accept": "node ./tools/run-game-acceptance.mjs",
     "icons:generate": "pnpm exec mpgd game icons generate . --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
@@ -17,19 +17,21 @@
     "build:ait": "pnpm exec mpgd target build ait staging --variant wrapper --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "build:ait:package": "pnpm exec mpgd target build ait production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "smoke:ait": "pnpm exec mpgd target smoke ait --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
-    "ait:wrapper:dev": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run dev",
-    "ait:wrapper:dev:plain": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run dev:plain",
-    "ait:wrapper:dev:phone": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run dev:phone",
-    "ait:devtools:mcp": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run devtools:mcp",
-    "ait:devtools:mcp:mobile": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run devtools:mcp:mobile",
+    "ait:wrapper:dev": "pnpm --dir apps/target-ait run dev",
+    "ait:wrapper:dev:plain": "pnpm --dir apps/target-ait run dev:plain",
+    "ait:wrapper:dev:phone": "pnpm --dir apps/target-ait run dev:phone",
+    "ait:devtools:mcp": "pnpm --dir apps/target-ait run devtools:mcp",
+    "ait:devtools:mcp:mobile": "pnpm --dir apps/target-ait run devtools:mcp:mobile",
     "ait:console:login": "aitcc login",
     "ait:console:whoami": "aitcc whoami",
     "ait:console:init": "aitcc app init",
     "ait:console:register": "aitcc app register",
     "ait:console:status": "aitcc app status",
     "ait:console:deploy": "aitcc app deploy",
-    "build:microsoft-store": "pnpm exec mpgd target build microsoft-store production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
-    "smoke:microsoft-store": "pnpm exec mpgd target smoke microsoft-store --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "build:microsoft-store": "pnpm exec mpgd target build microsoft-store production --targets-file ./mpgd.targets.json --kit-path \"${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}\"",
+    "smoke:microsoft-store": "pnpm exec mpgd target smoke microsoft-store --targets-file ./mpgd.targets.json --kit-path \"${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}\"",
+    "preflight:microsoft-store": "pnpm exec mpgd target preflight microsoft-store --targets-file ./mpgd.targets.json --kit-path \"${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}\"",
+    "package:microsoft-store": "pnpm exec mpgd target generate-package microsoft-store --targets-file ./mpgd.targets.json",
     "build:verse8": "pnpm exec mpgd target build verse8 production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "smoke:verse8": "pnpm exec mpgd target smoke verse8 --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "build:devvit": "pnpm exec mpgd target build reddit production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
@@ -56,7 +58,7 @@
   },
   "dependencies": {
     "@ait-co/polyfill": "^0.1.17",
-    "@apps-in-toss/web-framework": "^2.10.4",
+    "@apps-in-toss/web-framework": "^2.10.6",
     "@mpgd/adapter-ait": "__MPGD_DEPENDENCY_VERSION_ADAPTER_AIT__",
     "@mpgd/adapter-browser": "__MPGD_DEPENDENCY_VERSION_ADAPTER_BROWSER__",
     "@mpgd/adapter-capacitor": "__MPGD_DEPENDENCY_VERSION_ADAPTER_CAPACITOR__",

package/templates/phaser-game/vite.shared.ts

@@ -7,6 +7,7 @@ import type { UserConfig } from 'vite';
 interface RuntimePlatformTargetMetadata {
   readonly kind: string;
   readonly adapter: string;
+  readonly authoritativeGameServices?: boolean;
   readonly integrations?: Record<string, unknown>;
 }
 
@@ -174,9 +175,21 @@ function readRuntimePlatformTarget(
     throw new Error(`Platform target ${configTarget} integrations must be an object.`);
   }
 
+  if (
+    target.authoritativeGameServices !== undefined
+    && typeof target.authoritativeGameServices !== 'boolean'
+  ) {
+    throw new Error(
+      `Platform target ${configTarget} authoritativeGameServices must be a boolean.`,
+    );
+  }
+
   return {
     kind: target.kind,
     adapter: target.adapter,
+    ...(target.authoritativeGameServices === undefined
+      ? {}
+      : { authoritativeGameServices: target.authoritativeGameServices }),
     ...(target.integrations === undefined ? {} : { integrations: target.integrations }),
   };
 }