@playdrop/playdrop-cli 0.16.12 → 0.17.0

package/dist/commands/upload.d.ts

@@ -1,5 +1,5 @@
 import type { ApiClient } from "@playdrop/api-client";
-import type { AgentExecutionTarget, AppSurface, UserResponse } from "@playdrop/types";
+import type { AgentExecutionTarget, AppSurface, FinalizeAppUploadRequest, UserResponse } from "@playdrop/types";
 import { type AppTask } from "../catalogue";
 export type UploadCommandOptions = {
     env?: string;
@@ -27,6 +27,21 @@ export type WorkerAppPublishInput = {
     webBase?: string | null;
     token: string;
     user: UserResponse;
+    deterministicE2EFixture?: boolean;
+    prepareGitTransition?: (input: {
+        appId: number;
+        sessionId: string;
+        version: string;
+    }) => Promise<NonNullable<FinalizeAppUploadRequest["gitTransition"]>>;
+};
+export declare function resolveWorkerHostedValidationPolicy(input: {
+    kind: WorkerAppPublishInput["kind"];
+    deterministicE2EFixture?: boolean;
+}): {
+    runLocalLoadCheck: boolean;
+    runStagedUploadLoadCheck: boolean;
+    playtestSmokeCheckRequired: boolean;
+    skipReview: boolean;
 };
 export type WorkerAppPublishResult = {
     appId: number;
@@ -48,6 +63,7 @@ export type StaticHtmlPublishInput = {
     token: string;
     user: UserResponse;
     taskId?: number;
+    prepareGitTransition?: WorkerAppPublishInput["prepareGitTransition"];
     taskToken?: string;
     claimedAppName?: string | null;
     devRouterPort?: number;

package/dist/commands/upload.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveUploadOwner = resolveUploadOwner;
 exports.resolveDefaultUploadCreator = resolveDefaultUploadCreator;
 exports.upload = upload;
+exports.resolveWorkerHostedValidationPolicy = resolveWorkerHostedValidationPolicy;
 exports.assertAgentPrimarySurfaceContract = assertAgentPrimarySurfaceContract;
 exports.assertAgentNewGamePlaytestContract = assertAgentNewGamePlaytestContract;
 exports.assertAgentNewGameListingIdentity = assertAgentNewGameListingIdentity;
@@ -26,6 +27,9 @@ const taskSelection_1 = require("../taskSelection");
 const taskUtils_1 = require("../taskUtils");
 const uploadLog_1 = require("../uploadLog");
 const workerAppProject_1 = require("../workerAppProject");
+const listingPreflight_1 = require("../listingPreflight");
+const tweakStaleness_1 = require("../tweakStaleness");
+const e2e_fixtures_1 = require("./worker/e2e-fixtures");
 const upload_content_1 = require("./upload-content");
 const appUrls_1 = require("../appUrls");
 const ownedRuntimeImageValidation_1 = require("./ownedRuntimeImageValidation");
@@ -1236,6 +1240,15 @@ async function upload(pathOrName, options) {
     (0, uploadLog_1.printTaskSummary)(results, warnings, { action: "upload", environment: env });
     (0, uploadLog_1.printPublishedAppNextSteps)(results);
 }
+function resolveWorkerHostedValidationPolicy(input) {
+    const browserChecksRequired = input.deterministicE2EFixture !== true;
+    return {
+        runLocalLoadCheck: browserChecksRequired,
+        runStagedUploadLoadCheck: browserChecksRequired,
+        playtestSmokeCheckRequired: browserChecksRequired && input.kind === "NEW_GAME",
+        skipReview: !browserChecksRequired,
+    };
+}
 function assertAgentPrimarySurfaceContract(task, kind) {
     if (!task.primarySurface) {
         throw new Error(`agent_task_primary_surface_required: ${kind} catalogue.json must declare primarySurface.`);
@@ -1303,8 +1316,9 @@ async function prepareWorkerAppProject(input) {
     if (!creatorUsername) {
         throw new Error("agent_task_creator_username_missing");
     }
-    if (input.user.username !== creatorUsername && input.user.role !== "ADMIN") {
-        throw new Error(`worker_publish_on_behalf_requires_admin: the worker session user "${input.user.username}" cannot publish for "${creatorUsername}".`);
+    if (input.user.username !== creatorUsername &&
+        !(input.user.role === "CLOUD_WORKER" && input.taskId > 0 && input.taskToken.trim())) {
+        throw new Error(`worker_publish_on_behalf_requires_task: the worker session user "${input.user.username}" cannot publish for "${creatorUsername}" without an active Cloud Worker task.`);
     }
     const selection = (0, taskSelection_1.selectTasks)(input.projectDir);
     if (selection.errors.length > 0) {
@@ -1333,7 +1347,11 @@ async function prepareWorkerAppProject(input) {
     if ((input.kind === "NEW_GAME" || input.kind === "REMIX_GAME") && (appTask.type ?? "GAME") !== "GAME") {
         throw new Error(`agent_task_game_type_invalid:${appTask.type ?? "missing"}`);
     }
-    const task = (0, workerAppProject_1.prepareWorkerAppTask)(appTask);
+    const task = (0, workerAppProject_1.prepareWorkerAppTask)(appTask, true);
+    const workerContext = (0, listingPreflight_1.readWorkerUploadPreflightContext)(input.projectDir);
+    if (workerContext?.tweaks) {
+        (0, tweakStaleness_1.assertTweakStateMatches)(task, workerContext.tweaks);
+    }
     if (input.kind === "REMIX_GAME") {
         const expectedRemixRef = input.remixSourceRef?.trim() ?? "";
         if (!expectedRemixRef) {
@@ -1349,7 +1367,7 @@ async function prepareWorkerAppProject(input) {
     }
     await (0, apps_1.validateAppTask)(task);
     const isExternal = task.hostingMode === "EXTERNAL" || Boolean(task.externalUrl);
-    const artifacts = isExternal ? null : await (0, apps_1.buildApp)(task);
+    const artifacts = isExternal ? null : await (0, apps_1.buildApp)(task, { includeSourceArchive: false });
     await assertWorkerAppLocalUploadPreflight({
         task,
         kind: input.kind,
@@ -1379,6 +1397,19 @@ async function preflightWorkerAppProject(input) {
 async function publishWorkerAppProject(input) {
     const prepared = await prepareWorkerAppProject(input);
     const { task, artifacts, creatorUsername } = prepared;
+    if (input.deterministicE2EFixture) {
+        const fixtureDisplayName = task.displayName?.trim();
+        if (!fixtureDisplayName) {
+            throw new Error("playdrop_e2e_fixture_display_name_missing");
+        }
+        await (0, e2e_fixtures_1.validatePlaydropE2EGameFixture)({
+            projectDir: input.projectDir,
+            taskId: input.taskId,
+            kind: input.kind,
+            displayName: fixtureDisplayName,
+        });
+    }
+    const validationPolicy = resolveWorkerHostedValidationPolicy(input);
     const { app } = await (0, registration_1.ensureRegisteredHostedAppShell)({
         client: input.client,
         creatorUsername,
@@ -1403,12 +1434,14 @@ async function publishWorkerAppProject(input) {
         webBase: normalizePortalBase(input.webBase ?? undefined),
         token: input.token,
         user: input.user,
-        runLocalLoadCheck: true,
-        runStagedUploadLoadCheck: true,
+        runLocalLoadCheck: validationPolicy.runLocalLoadCheck,
+        runStagedUploadLoadCheck: validationPolicy.runStagedUploadLoadCheck,
         ensureRegisteredAppShell: true,
         agentTaskId: input.taskId,
-        playtestSmokeCheckRequired: input.kind === "NEW_GAME",
+        playtestSmokeCheckRequired: validationPolicy.playtestSmokeCheckRequired,
+        skipReview: validationPolicy.skipReview,
         captureSession,
+        prepareGitTransition: input.prepareGitTransition,
         ...(artifacts ? { artifacts } : {}),
     });
     if (!uploadResult.versionCreated || !uploadResult.version) {
@@ -1435,8 +1468,9 @@ async function publishStaticHtmlProject(input) {
     if (!creatorUsername) {
         throw new Error("static_game_publish_creator_username_missing");
     }
-    if (input.user.username !== creatorUsername && input.user.role !== "ADMIN") {
-        throw new Error(`static_game_publish_on_behalf_requires_admin:${input.user.username}:${creatorUsername}`);
+    if (input.user.username !== creatorUsername &&
+        !(input.user.role === "CLOUD_WORKER" && Number(input.taskId) > 0 && input.taskToken?.trim())) {
+        throw new Error(`static_game_publish_on_behalf_requires_task:${input.user.username}:${creatorUsername}`);
     }
     const prepared = await (0, staticHtml_1.prepareStaticHtmlProject)({
         projectDir: input.projectDir,
@@ -1444,6 +1478,7 @@ async function publishStaticHtmlProject(input) {
         appName: input.claimedAppName?.trim() || undefined,
         primarySurface: input.primarySurface,
         cdnBase: input.cdnBase,
+        gameSourceGit: true,
     });
     try {
         if (input.taskId !== undefined && !input.claimedAppName?.trim()) {
@@ -1485,6 +1520,7 @@ async function publishStaticHtmlProject(input) {
         const captureSession = input.taskId !== undefined && input.taskToken?.trim()
             ? { appId, taskId: input.taskId, taskToken: input.taskToken.trim() }
             : null;
+        const staticArtifacts = prepared.artifacts;
         const { upload, warnings } = await (0, apps_1.runAppPipeline)(input.client, prepared.runtimeTask, {
             creatorUsername,
             apiBase: input.apiBase,
@@ -1499,7 +1535,8 @@ async function publishStaticHtmlProject(input) {
             playtestSmokeCheckRequired: false,
             skipReview: input.skipReview,
             captureSession,
-            artifacts: prepared.artifacts,
+            prepareGitTransition: input.prepareGitTransition,
+            artifacts: staticArtifacts,
         });
         if (!upload.version || !Number.isInteger(upload.versionId) || !upload.versionNodeId?.trim()) {
             throw new Error("static_game_publish_version_result_missing");

package/dist/commands/worker/archive-staging.d.ts

@@ -1,6 +1,7 @@
 type WorkspaceArchiveStageInput = {
     downloadUrl: string;
     expectedSize: number;
+    expectedSha256: string;
     targetDir: string;
     timeoutMs: number;
 };

package/dist/commands/worker/archive-staging.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractZipArchive = extractZipArchive;
 exports.stageWorkspaceArchiveInChild = stageWorkspaceArchiveInChild;
 const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
 const node_os_1 = __importDefault(require("node:os"));
@@ -27,9 +28,14 @@ function normalizeStageInput(value) {
     const input = value && typeof value === "object" && !Array.isArray(value) ? value : null;
     const downloadUrl = typeof input?.downloadUrl === "string" ? input.downloadUrl.trim() : "";
     const expectedSize = Number(input?.expectedSize);
+    const expectedSha256 = typeof input?.expectedSha256 === "string" ? input.expectedSha256.trim().toLowerCase() : "";
     const targetDir = typeof input?.targetDir === "string" ? input.targetDir.trim() : "";
     const timeoutMs = Number(input?.timeoutMs);
-    if (!downloadUrl || !Number.isInteger(expectedSize) || expectedSize <= 0 || !node_path_1.default.isAbsolute(targetDir)) {
+    if (!downloadUrl ||
+        !Number.isInteger(expectedSize) ||
+        expectedSize <= 0 ||
+        !/^[0-9a-f]{64}$/.test(expectedSha256) ||
+        !node_path_1.default.isAbsolute(targetDir)) {
         throw new Error("agent_task_workspace_archive_stager_input_invalid");
     }
     if (expectedSize > WORKSPACE_ARCHIVE_MAX_DOWNLOAD_BYTES) {
@@ -38,7 +44,7 @@ function normalizeStageInput(value) {
     if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {
         throw new Error("agent_task_workspace_archive_download_timeout_invalid");
     }
-    return { downloadUrl, expectedSize, targetDir, timeoutMs };
+    return { downloadUrl, expectedSize, expectedSha256, targetDir, timeoutMs };
 }
 function assertWorkspaceArchiveExtractionBounds(buffer) {
     if (buffer.length < ZIP_END_OF_CENTRAL_DIRECTORY_MIN_BYTES) {
@@ -166,6 +172,7 @@ async function downloadAndExtractWorkspaceArchive(input) {
         }
         const reader = response.body.getReader();
         const file = await (0, promises_1.open)(archivePath, "wx");
+        const hash = (0, node_crypto_1.createHash)("sha256");
         let receivedBytes = 0;
         try {
             while (true) {
@@ -174,6 +181,7 @@ async function downloadAndExtractWorkspaceArchive(input) {
                     break;
                 }
                 const buffer = Buffer.from(chunk.value);
+                hash.update(buffer);
                 if (receivedBytes + buffer.length > input.expectedSize) {
                     throw new Error(`agent_task_workspace_archive_size_mismatch:${receivedBytes + buffer.length}>${input.expectedSize}`);
                 }
@@ -194,6 +202,9 @@ async function downloadAndExtractWorkspaceArchive(input) {
         if (receivedBytes !== input.expectedSize) {
             throw new Error(`agent_task_workspace_archive_size_mismatch:${receivedBytes}!=${input.expectedSize}`);
         }
+        if (hash.digest("hex") !== input.expectedSha256) {
+            throw new Error("agent_task_workspace_archive_sha_mismatch");
+        }
         const buffer = await (0, promises_1.readFile)(archivePath);
         await (0, promises_1.mkdir)(extractedDir, { recursive: true });
         extractZipArchive(new Uint8Array(buffer), extractedDir);

package/dist/commands/worker/e2e-fixtures.d.ts

@@ -0,0 +1,32 @@
+import type { AgentTaskGenerationKind, AgentTaskKind } from "@playdrop/types";
+export type PlaydropE2EFixtureKind = "NEW_GAME" | "GAME_UPDATE" | "REMIX_GAME" | "IMAGE" | "MODEL_3D" | "VIDEO" | "SFX" | "SPEECH" | "MUSIC";
+export declare const PLAYDROP_E2E_MARKERS: Readonly<Record<PlaydropE2EFixtureKind, string>>;
+export declare function detectPlaydropE2EFixture(input: string): PlaydropE2EFixtureKind | null;
+export declare function isPlaydropE2EGameKind(kind: AgentTaskKind): kind is Extract<PlaydropE2EFixtureKind, "NEW_GAME" | "GAME_UPDATE" | "REMIX_GAME">;
+export declare function isPlaydropE2EMediaKind(kind: AgentTaskGenerationKind): kind is Extract<PlaydropE2EFixtureKind, "IMAGE" | "MODEL_3D" | "VIDEO" | "SFX" | "SPEECH" | "MUSIC">;
+export declare function buildPlaydropE2EScreeningOutput(prompt: string): Record<string, unknown>;
+export declare function writePlaydropE2EPng(input: {
+    filePath: string;
+    width: number;
+    height: number;
+    label: string;
+}): Promise<void>;
+export declare function validatePlaydropE2EGameFixture(input: {
+    projectDir: string;
+    taskId: number;
+    kind: "NEW_GAME" | "GAME_UPDATE" | "REMIX_GAME";
+    displayName: string;
+}): Promise<void>;
+export declare function replaceWithPlaydropE2EGameFixture(input: {
+    projectDir: string;
+    taskId: number;
+    kind: "NEW_GAME" | "GAME_UPDATE" | "REMIX_GAME";
+    appName: string;
+    displayName: string;
+    subtitle: string;
+    primarySurface: "DESKTOP" | "MOBILE_LANDSCAPE" | "MOBILE_PORTRAIT";
+    outputVersion: string;
+    remixSourceRef: string | null;
+}): Promise<void>;
+export declare function buildPlaydropE2EMetadata(kind: AgentTaskGenerationKind): Record<string, unknown>;
+export declare function buildPlaydropE2ETriangleGlb(): Buffer;