@mpgd/cli 0.14.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -50,18 +50,18 @@
     "@types/node": "^24.0.0",
     "ttsc": "0.18.4",
     "typescript": "7.0.2",
-    "@mpgd/adapter-ait": "0.4.4",
-    "@mpgd/adapter-browser": "0.5.0",
     "@mpgd/adapter-capacitor": "0.4.4",
+    "@mpgd/adapter-browser": "0.5.0",
     "@mpgd/adapter-devvit": "0.8.4",
-    "@mpgd/analytics": "0.3.7",
     "@mpgd/adapter-verse8": "0.2.1",
+    "@mpgd/adapter-ait": "0.5.0",
+    "@mpgd/analytics": "0.3.7",
     "@mpgd/bridge": "0.6.1",
-    "@mpgd/catalog": "0.5.0",
-    "@mpgd/game-services": "0.10.0",
     "@mpgd/i18n": "0.5.3",
+    "@mpgd/game-services": "0.10.0",
+    "@mpgd/catalog": "0.5.0",
     "@mpgd/phaser-assets": "0.4.1",
-    "@mpgd/target-config": "0.8.0",
+    "@mpgd/target-config": "0.9.0",
     "@mpgd/platform": "0.7.0"
   },
   "main": "./dist/index.js",

package/templates/phaser-game/.agents/skills/release-microsoft-store/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: release-microsoft-store
+description: Prepare, package, and verify this game's Microsoft Store PWA release. Use when configuring Store identity or listing data, building the microsoft-store target, running submission preflight, generating a PWABuilder package ZIP, inspecting MSIX/AppX bundles, collecting optional WACK evidence, or preparing Partner Center submission evidence.
+---
+
+# Release to Microsoft Store
+
+Read `docs/MPGD_KIT_WORKFLOWS.md`, `mpgd.microsoft-store.json`, and the
+`microsoft-store` entry in `mpgd.targets.json`. If the target is absent, stop
+and run `pnpm exec mpgd target init microsoft-store --game .` before editing
+Store-specific files.
+
+## Prepare the PWA
+
+1. Replace every placeholder in `mpgd.microsoft-store.json` with the reserved
+   Partner Center identity, publisher, listing, age-rating, privacy, and
+   screenshot data.
+2. Keep the web manifest ID, start URL, scope, orientation, icons, and deployed
+   URL aligned with the game-owned PWA.
+3. Generate and verify production icons with `pnpm icons:generate` and
+   `pnpm icons:verify`.
+4. Run `pnpm build:microsoft-store`, `pnpm smoke:microsoft-store`, and
+   `pnpm preflight:microsoft-store`. Fix warnings that reflect missing
+   submission inputs; retain the resulting preflight JSON and Markdown.
+
+## Generate and accept packages
+
+1. Deploy the exact bytes that passed preflight. Do not rebuild between
+   preflight, deployment, and package generation.
+2. Set `PWA_URL` and `MANIFEST_URL` to the public production endpoints, then
+   run:
+
+   ```sh
+   pnpm package:microsoft-store -- \
+     --pwa-url "$PWA_URL" \
+     --manifest-url "$MANIFEST_URL" \
+     --package-version <four-part-version> \
+     --classic-version <lower-four-part-version>
+   ```
+
+3. Keep `release-input/microsoft-store/pwabuilder-package.zip` together with
+   `release-output/microsoft-store/package-generation.json` and `.md`.
+4. On Windows with the current SDK, inspect the generated MSIX/AppX bundles
+   using:
+
+   ```sh
+   pnpm exec mpgd target accept-package microsoft-store \
+     --packages <game-relative-package-paths>
+   ```
+
+   Keep `package-acceptance.json` and `.md`.
+5. Treat WACK as optional recommended evidence. Pass `--appcert
+   <path-to-appcert.exe>` only when the active Windows environment can run it;
+   do not block otherwise valid package acceptance solely because WACK was not
+   run.
+
+Require identity, version, signature, payload, submission-evidence, and package
+hash checks to pass before Partner Center submission. Never grant purchases
+from client callbacks; add Store commerce only through a dedicated adapter and
+backend ledger verification.

package/templates/phaser-game/.agents/skills/release-microsoft-store/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Release to Microsoft Store"
+  short_description: "Build and verify Microsoft Store PWA releases"
+  default_prompt: "Prepare this game for a Microsoft Store PWA release and produce the required acceptance evidence."

package/templates/phaser-game/.agents/skills/use-mpgd-kit/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: use-mpgd-kit
+description: Route Phaser game development, platform integration, target builds, icons, localization, analytics, game services, acceptance, and release work through this generated game's mpgd-kit contracts. Use for any change that adds gameplay-facing platform behavior, configures a distribution target, prepares release evidence, or needs to discover which mpgd capability and validation flow applies.
+---
+
+# Use mpgd-kit
+
+Read `AGENTS.md`, `agent/game-manifest.json`, and
+`docs/MPGD_KIT_WORKFLOWS.md` before editing. Treat the manifest as the list of
+enabled targets and the workflow guide as the routing reference.
+
+## Route the request
+
+- Put deterministic state and rules in game/simulation modules.
+- Keep Phaser scenes limited to rendering and input glue.
+- Route identity, storage, commerce, ads, leaderboard, lifecycle, and host
+  presentation through `PlatformGateway`.
+- Keep SDK imports in adapters or target wrappers.
+- Route purchases, rewarded-ad grants, and verified scores through a backend
+  ledger or verifier before mutating durable state.
+- Use `@mpgd/target-config` for target-owned runtime configuration and
+  `mpgd.targets.json` for build ownership.
+- Use the generated icon, localization, analytics, acceptance, and evidence
+  flows instead of creating target-specific copies.
+- For a configured target with a target skill in `agent/game-manifest.json`,
+  read that skill before changing its release flow.
+
+## Work in order
+
+1. Identify the owning capability and files from the manifest and workflow
+   guide.
+2. Inspect the target entry and effective configuration; do not assume a target
+   is enabled.
+3. Implement the smallest change that preserves `PlatformGateway` and backend
+   authority boundaries.
+4. Update `agent/game-manifest.json`, `agent/brief.md`, and acceptance guidance
+   when the game's capabilities or handoff contract changes.
+5. Run the focused check first, then `pnpm check`, `pnpm build`, and
+   `pnpm accept` when the change affects a handoff or target release.
+6. Preserve generated JSON/Markdown evidence under `artifacts/acceptance` or
+   the target's `release-output` directory.
+
+Use official target documentation or the target's configured MCP for SDK and
+submission requirements. Do not commit personal MCP configuration, tokens,
+credentials, signing material, or platform login state.

package/templates/phaser-game/.agents/skills/use-mpgd-kit/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Use mpgd-kit"
+  short_description: "Route game work through mpgd-kit workflows"
+  default_prompt: "Use the mpgd-kit workflow guide and project manifest to implement and validate this game change."

package/templates/phaser-game/AGENTS.md

@@ -0,0 +1,34 @@
+# Generated Game Agent Instructions
+
+This repository is a standalone Phaser game generated with `@mpgd/create-game`.
+
+## Start here
+
+- Read `agent/game-manifest.json` for enabled targets, capability ownership, and
+  target-specific skills.
+- Use `.agents/skills/use-mpgd-kit/SKILL.md` for game, platform, target, build,
+  acceptance, or release work.
+- Read `docs/MPGD_KIT_WORKFLOWS.md` only for the relevant capability or target.
+- Keep `agent/brief.md` and `agent/acceptance.md` aligned with material changes.
+
+## Boundaries
+
+- Keep deterministic game state outside Phaser scenes.
+- Keep platform SDK imports in adapters or target wrappers.
+- Use `PlatformGateway` from game-facing code; do not call platform SDKs from
+  scenes.
+- Keep pure game packages free of Phaser, DOM, network, and platform SDKs.
+- Send purchases, rewarded-ad grants, and verified scores through backend
+  ledger or verifier APIs before changing durable state.
+- Do not put side effects inside debug calls that a production strip pass may
+  remove.
+- Do not commit secrets, signing keys, personal MCP configuration, or platform
+  authentication state.
+
+## Tooling and checks
+
+- Use `ttsx`, not `tsx`, for TypeScript scripts.
+- Use `ttsc` and `@ttsc/lint`; do not add ESLint or Prettier for TypeScript.
+- Run focused checks, then `pnpm check` and `pnpm build`.
+- Run `pnpm accept` before a target handoff or release. Keep its evidence and
+  any target-specific release evidence with the handoff.

package/templates/phaser-game/README.md

@@ -2,6 +2,11 @@
 
 Standalone Phaser 4 game starter generated by `@mpgd/create-game`.
 
+For agent-assisted work, start with `AGENTS.md`, then use
+`.agents/skills/use-mpgd-kit/SKILL.md` and
+`docs/MPGD_KIT_WORKFLOWS.md` to route platform, content, service, target, and
+release changes through the generated game manifest.
+
 ## Local Loop
 
 ```sh
@@ -31,17 +36,17 @@ platform-specific artifacts. Keep an `mpgd-kit` checkout nearby and pass it with
 pnpm exec mpgd target build-all \
   --targets-file ./mpgd.targets.json \
   --kit-path ../mpgd-kit \
-  --targets web,microsoft-store,verse8,ait,reddit \
+  --targets __RECOMMENDED_MATRIX_TARGETS__ \
   --profile staging \
   --ait-variant wrapper
 pnpm exec mpgd target smoke-all \
   --targets-file ./mpgd.targets.json \
   --kit-path ../mpgd-kit \
-  --targets web,microsoft-store,verse8,ait,reddit
+  --targets __RECOMMENDED_MATRIX_TARGETS__
 pnpm exec mpgd target doctor \
   --targets-file ./mpgd.targets.json \
   --kit-path ../mpgd-kit \
-  --targets web,microsoft-store,verse8,ait,reddit
+  --targets __RECOMMENDED_MATRIX_TARGETS__
 ```
 
 When developing the kit itself, the same commands work through the repository
@@ -51,7 +56,7 @@ script:
 pnpm --dir ../mpgd-kit mpgd target build-all \
   --targets-file "$PWD/mpgd.targets.json" \
   --kit-path ../mpgd-kit \
-  --targets web,microsoft-store,verse8,ait,reddit \
+  --targets __RECOMMENDED_MATRIX_TARGETS__ \
   --profile staging \
   --ait-variant wrapper
 ```
@@ -60,18 +65,30 @@ pnpm --dir ../mpgd-kit mpgd target build-all \
 into `.mpgd.targets.generated.json` before calling the kit's existing target
 build and smoke scripts.
 
-The starter's Apps in Toss and Capacitor entries intentionally point at kit
-reference wrappers, so their reusable validation builds use the `staging`
-profile. Before an AIT, Android, or iOS production build, copy or create the
-wrapper/shell under this game directory, update `mpgd.targets.json`, and set
-`VITE_MPGD_GAME_SERVICES_URL` to a public HTTPS endpoint without embedded
-credentials. Production preflight resolves real paths, rejects wrappers or
-shells outside the game root (including symbolic-link escapes), and blocks
-localhost plus literal private or reserved IP addresses.
+The starter owns its Apps in Toss wrapper under `apps/target-ait`. With
+`authoritativeGameServices: false`, production keeps native identity, storage,
+sharing, and Game Center while disabling IAP and ads; no game-services URL is
+required for that fail-closed first release. To enable purchases or ads later,
+set the authority flag to `true`, add app-owned product or ad IDs, and configure
+`VITE_MPGD_GAME_SERVICES_URL` to a public HTTPS verifier without embedded
+credentials.
+
+The Capacitor entries still intentionally point at kit reference shells, so
+their reusable validation builds use the `staging` profile. Before an Android
+or iOS production build, copy or create the shell under this game directory and
+update `mpgd.targets.json`. Production preflight resolves real paths, rejects
+wrappers or shells outside the game root (including symbolic-link escapes), and
+blocks localhost plus literal private or reserved IP addresses.
 
 `mpgd target doctor` verifies that release manifest artifact paths stay under
-this game directory, even when a build used the kit reference Apps in Toss or
-Capacitor wrappers.
+this game directory, including non-production builds that use kit reference
+Capacitor shells.
+
+Optional targets can add their own config, scripts, runtime wiring, and release
+skill. To enable Microsoft Store after creation, run
+`pnpm exec mpgd target init microsoft-store --game . --kit-path ../mpgd-kit`.
+The initializer is idempotent and stops before writing when it finds conflicting
+game-owned values.
 
 ## Acceptance Handoff
 
@@ -145,7 +162,7 @@ hard-lock the device. Use `responsive` when both orientations are playable,
 `prefer-landscape` or `prefer-portrait` when layout guidance should favor one
 orientation, and `lock-landscape` or `lock-portrait` when the game should show a
 soft rotate prompt on mismatch. The generated PWA manifest also declares
-`"orientation": "landscape"` for installed web and Microsoft Store shells; keep
+`"orientation": "landscape"` for installed web shells; keep
 that manifest value aligned with the runtime policy if you make a portrait-first
 game.
 
@@ -213,8 +230,8 @@ pnpm build:ait
 pnpm smoke:ait
 ```
 
-The kit reference wrapper includes the Apps in Toss community devtools package
-for SDK mock and device debugging while the wrapper is still kit-owned:
+The game-owned wrapper includes the Apps in Toss community devtools package for
+SDK mocks and device debugging:
 
 ```sh
 pnpm ait:wrapper:dev
@@ -224,7 +241,7 @@ pnpm ait:devtools:mcp
 pnpm ait:devtools:mcp:mobile
 ```
 
-`ait:wrapper:dev` runs the kit wrapper with the community Vite plugin enabled.
+`ait:wrapper:dev` runs `apps/target-ait` with the community Vite plugin enabled.
 It loads the last game bundle copied by `pnpm build:ait` from the wrapper's
 `public/game` directory, so run `pnpm build:ait` again after game changes before
 opening a wrapper devtools session. Use `ait:wrapper:dev:plain` to disable the
@@ -255,15 +272,15 @@ pnpm ait:console:deploy -- release-output/ait/YOUR_APP.ait
 `ait:console:register` creates the mini-app and writes its `miniAppId` back to
 that file. Before registration, add the real logo, thumbnail, and screenshot
 files referenced by `aitcc.yaml` under `./assets/`. Use `pnpm build:ait` for the
-kit wrapper smoke loop, and run `pnpm build:ait:package` before console deploys
-so `release-output/ait/` contains the `.ait` bundle you pass after `--`.
+game-owned wrapper smoke loop, and run `pnpm build:ait:package` before console
+deploys so `release-output/ait/` contains the `.ait` bundle you pass after `--`.
 
 The starter also installs `@apps-in-toss/web-framework` and awaits
 `install()` from `@ait-co/polyfill` only when `__APP_TARGET__` is `ait`. In the
 Apps in Toss WebView runtime, standard Web APIs such as `navigator.clipboard`,
 `navigator.geolocation`, `navigator.share`, `navigator.vibrate`, network status,
 and `_blank` `window.open` calls route through the Apps in Toss SDK. Plain
-browser, Microsoft Store, Reddit, Android, and iOS builds do not import the AIT
+browser, Reddit, Android, and iOS builds do not import the AIT
 SDK chunk and keep their native browser behavior. `pnpm dev:ait` is useful for
 checking the AIT-gated bundle path, but SDK-backed API behavior should be
 verified in the Apps in Toss sandbox or a game-owned devtools setup. If your
@@ -271,9 +288,16 @@ game uses permission-gated APIs such as clipboard or geolocation, declare the
 matching permissions in the game-owned Apps in Toss `granite.config.ts` before
 submission.
 
+The generated AIT target starts with `authoritativeGameServices: false`. Native
+anonymous identity, persistent Storage, sharing, and Game Center remain
+available, while IAP and ads are removed from the effective game configuration.
+Only switch the flag to `true` after adding app-owned catalog/ad ids and a public
+HTTPS game-services backend that verifies purchase or reward evidence.
+
 ## Target Ownership Notes
 
 - Browser preview is fully game-owned and writes to `artifacts/web-preview`.
+<!-- mpgd:microsoft-store:start -->
 - Microsoft Store is a game-owned PWA target that reuses the browser adapter and
   writes to `artifacts/microsoft-store` with `manifest.webmanifest` for
   PWABuilder packaging. Replace the starter icon and manifest metadata before
@@ -323,6 +347,7 @@ submission.
   recommended optional local check; from an active administrator user session,
   pass `--appcert <path-to-appcert.exe>` to require `OVERALL_RESULT="PASS"`
   and bind its report hash.
+<!-- mpgd:microsoft-store:end -->
 - Verse8 is a game-owned iframe web target that writes to `artifacts/verse8`.
   The adapter verifies the host-provided auth credential and distinguishes
   Verse8-signed accounts from self-signed guest accounts. Ads are available
@@ -343,10 +368,10 @@ submission.
 - Reddit Devvit is game-owned in `apps/target-devvit`. Its Redis-backed storage
   bridge fails closed on identity, provider, serialization, and quota errors;
   it never switches progress to browser `localStorage`.
-- Apps in Toss currently uses the kit reference wrapper at
-  `${MPGD_KIT_PATH}/apps/target-ait` for smoke packaging. Before a real Toss
-  submission, create a game-owned wrapper/config so the app name, CLI state, and
-  review metadata are not shared with the kit demo.
+- Apps in Toss is game-owned in `apps/target-ait`. The wrapper keeps the app
+  name, console state, review metadata, and `@ait-co/devtools` development
+  integration local to the game while reusing `@mpgd/adapter-ait` for the
+  production bridge and game-bundle loader.
 - Android and iOS currently use the kit reference Capacitor shell at
   `${MPGD_KIT_PATH}/apps/mobile-capacitor`. That is useful for local artifact
   checks, and final artifacts are copied back to this game's `release-output/`

package/templates/phaser-game/agent/acceptance.md

@@ -2,6 +2,10 @@
 
 Run these checks before handing off a generated game starter:
 
+Use `agent/game-manifest.json` and `.agents/skills/use-mpgd-kit/SKILL.md` to
+select any target-specific acceptance workflow required by the configured
+targets.
+
 ```sh
 pnpm icons:generate
 pnpm icons:verify
@@ -32,9 +36,13 @@ Play here starts gameplay inside the post, and the `game` entry opens the
 separate expanded mode Phaser document. Inline gameplay must remain tap/click
 only and must not trap feed scrolling.
 
+<!-- mpgd:microsoft-store:start -->
 For Microsoft Store changes, keep the first pass as a PWA/web target that uses
 the browser adapter. Add a dedicated Store commerce adapter only when wiring
 Digital Goods API and Payment Request through backend ledger verification.
+Run the generated Store release skill from build and preflight through package
+acceptance; WACK is optional recommended evidence.
+<!-- mpgd:microsoft-store:end -->
 
 ## Verse8 Agent8 Structured Server
 

package/templates/phaser-game/agent/brief.md

@@ -2,6 +2,10 @@
 
 Build a Phaser 4 game on top of the mpgd platform boundary.
 
+Read `AGENTS.md`, `agent/game-manifest.json`, and the generated
+`.agents/skills/use-mpgd-kit/SKILL.md` router before changing kit-facing
+capabilities or target workflows.
+
 Boundaries:
 
 - Phaser scenes render and collect input only.
@@ -20,8 +24,16 @@ pnpm check
 pnpm build
 pnpm icons:generate
 pnpm icons:verify
-pnpm exec mpgd target build-all --targets-file ./mpgd.targets.json --kit-path ../mpgd-kit --targets web,microsoft-store,verse8,ait,reddit --profile staging --ait-variant wrapper
+pnpm exec mpgd target build-all --targets-file ./mpgd.targets.json --kit-path ../mpgd-kit --targets __RECOMMENDED_MATRIX_TARGETS__ --profile staging --ait-variant wrapper
 pnpm devvit:login
 pnpm devvit:init
 pnpm devvit:playtest
 ```
+
+<!-- mpgd:microsoft-store:start -->
+For Microsoft Store releases, use the generated
+`.agents/skills/release-microsoft-store/SKILL.md` workflow. Build and preflight
+the game-owned PWA before package generation, then run package acceptance on
+Windows before Partner Center submission. WACK remains an optional recommended
+evidence source, not a universal prerequisite.
+<!-- mpgd:microsoft-store:end -->

package/templates/phaser-game/agent/game-manifest.json

@@ -8,6 +8,13 @@
   "targets": ["web-preview", "microsoft-store", "verse8", "android", "ios", "ait", "reddit"],
   "futureTargets": ["telegram", "tauri"],
   "platformBoundary": "PlatformGateway",
+  "agentWorkflow": {
+    "guide": "docs/MPGD_KIT_WORKFLOWS.md",
+    "routerSkill": ".agents/skills/use-mpgd-kit/SKILL.md",
+    "targetSkills": {
+      "microsoft-store": ".agents/skills/release-microsoft-store/SKILL.md"
+    }
+  },
   "mcpRequirements": {
     "ait": "Use apps-in-toss MCP before Apps in Toss SDK or review-flow changes.",
     "reddit": "Use Devvit documentation/MCP before Devvit SDK or publish-flow changes. Keep Reddit deployment files in apps/target-devvit."

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

@@ -0,0 +1,35 @@
+import { defineConfig, type AppsInTossWebConfig } from '@apps-in-toss/web-framework/config';
+
+const config: AppsInTossWebConfig = {
+  appName: readEnvString(process.env.MPGD_AIT_APP_NAME) ?? '__GAME_NAME__',
+  brand: {
+    displayName: readEnvString(process.env.MPGD_AIT_DISPLAY_NAME) ?? '__GAME_TITLE__',
+    primaryColor: readEnvString(process.env.MPGD_AIT_PRIMARY_COLOR) ?? '#101820',
+    icon: readEnvString(process.env.MPGD_AIT_BRAND_ICON_URL) ?? 'generated/console-icon.png',
+  },
+  permissions: [],
+  web: {
+    host: 'localhost',
+    port: 5173,
+    commands: {
+      dev: 'pnpm dev',
+      build: 'pnpm build',
+    },
+  },
+  webViewProps: {
+    bounces: false,
+    pullToRefreshEnabled: false,
+    overScrollMode: 'never',
+    allowsBackForwardNavigationGestures: false,
+    allowsInlineMediaPlayback: true,
+  },
+};
+
+const definedConfig: AppsInTossWebConfig = defineConfig(config);
+
+export default definedConfig;
+
+function readEnvString(input: string | undefined): string | undefined {
+  const trimmed = input?.trim();
+  return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;
+}

package/templates/phaser-game/apps/target-ait/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"
+    />
+    <title>__GAME_TITLE__</title>
+  </head>
+  <body>
+    <main id="app"></main>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

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

@@ -0,0 +1,33 @@
+{
+  "name": "__PACKAGE_NAME__-target-ait",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 0.0.0.0",
+    "dev:plain": "MPGD_AIT_DEVTOOLS=0 VITE_MPGD_AIT_MOCK_IDENTITY=1 vite --host 0.0.0.0",
+    "dev:phone": "AIT_TUNNEL=1 AIT_TUNNEL_CDP=1 vite --host 0.0.0.0",
+    "build": "vite build",
+    "ait:build": "ait build",
+    "ait:deploy": "ait deploy --api-key \"$AIT_API_KEY\"",
+    "devtools:mcp": "pnpm exec devtools-mcp",
+    "devtools:mcp:mobile": "pnpm exec devtools-mcp --target=mobile",
+    "check": "ttsc --noEmit -p tsconfig.json",
+    "lint": "ttsc --noEmit -p tsconfig.json",
+    "format": "ttsc format",
+    "fix": "ttsc fix"
+  },
+  "dependencies": {
+    "@apps-in-toss/web-framework": "^2.10.6",
+    "@mpgd/adapter-ait": "__MPGD_DEPENDENCY_VERSION_ADAPTER_AIT__"
+  },
+  "devDependencies": {
+    "@ait-co/devtools": "^0.1.138",
+    "@apps-in-toss/cli": "^2.10.6",
+    "@ttsc/unplugin": "0.18.4",
+    "@types/node": "^24.0.0",
+    "ttsc": "0.18.4",
+    "typescript": "7.0.2",
+    "vite": "^8.1.3"
+  }
+}

package/templates/phaser-game/apps/target-ait/src/main.ts

@@ -0,0 +1,34 @@
+import './styles.css';
+
+import { installAitHostBridge, type InstallAitHostBridgeOptions } from '@mpgd/adapter-ait/host';
+import { mountAitGameBundle } from '@mpgd/adapter-ait/wrapper';
+
+declare const __MPGD_AIT_APP_NAME__: string;
+declare const __MPGD_AIT_AD_GROUP_IDS__: Readonly<Record<string, string>>;
+declare const __MPGD_AIT_AD_PLACEMENT_TYPES__: Readonly<
+  Record<string, 'rewarded' | 'interstitial'>
+>;
+
+installAitHostBridge({
+  appName: __MPGD_AIT_APP_NAME__,
+  adGroupIds: __MPGD_AIT_AD_GROUP_IDS__,
+  adPlacementTypes: __MPGD_AIT_AD_PLACEMENT_TYPES__,
+  ...identityBridgeOptions(),
+});
+
+const app = document.querySelector<HTMLElement>('#app');
+if (app !== null) {
+  void mountAitGameBundle(app).catch((error: unknown) => {
+    console.error('AIT game bundle mount failed unexpectedly.', error);
+  });
+}
+
+function identityBridgeOptions(): Pick<InstallAitHostBridgeOptions, 'dependencies'> {
+  return import.meta.env.VITE_MPGD_AIT_MOCK_IDENTITY === '1'
+    ? {
+        dependencies: {
+          identityProvider: async () => ({ type: 'HASH', hash: 'ait-local-player' }),
+        },
+      }
+    : {};
+}

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);
+}