@playcraft/cli 0.1.49-beta → 0.1.51
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -62
- package/dist/agent/local-backend.js +1 -1
- package/dist/cli-root-help.js +0 -2
- package/dist/commands/build-all.js +19 -5
- package/dist/commands/build.js +28 -15
- package/dist/commands/create.js +33 -26
- package/dist/commands/image.js +6 -2
- package/dist/commands/login.js +42 -84
- package/dist/commands/skills.js +0 -4
- package/dist/commands/tools-3d.js +0 -11
- package/dist/commands/tools-generation.js +137 -69
- package/dist/commands/tools-image-context.js +29 -0
- package/dist/commands/tools-utils.js +12 -0
- package/dist/commands/tools.js +2 -2
- package/dist/config.js +4 -59
- package/dist/index.js +3 -40
- package/dist/remix/clone.js +0 -2
- package/dist/remix/init-template.js +0 -2
- package/dist/remix/pull.js +0 -2
- package/dist/remix/push.js +1 -21
- package/dist/utils/agent-api-client.js +30 -210
- package/dist/utils/image-asset-context.js +228 -0
- package/dist/utils/playcraft-http-client.js +4 -6
- package/package.json +5 -15
- package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
- package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
- package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
- package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
- package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
- package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- package/SKILLS_REGISTRY.md +0 -149
- package/dist/auth/account-activation.js +0 -157
- package/dist/auth/messages.js +0 -30
- package/dist/commands/build-temp.js +0 -26
- package/dist/commands/platform-skills.generated.js +0 -19
- package/dist/commands/playable.js +0 -53
- package/dist/commands/tools-batch.js +0 -113
- package/dist/commands/video.js +0 -122
- package/dist/commands/workspace-runtime.js +0 -54
- package/dist/commands/workspace.js +0 -40
- package/dist/project-skills/builtin-import.js +0 -225
- package/dist/project-skills/commands.js +0 -77
- package/dist/project-skills/lifecycle.js +0 -28
- package/dist/project-skills/local-run.js +0 -112
- package/dist/project-skills/local-store.js +0 -221
- package/dist/project-skills/messages.js +0 -80
- package/dist/project-skills/reconcile.js +0 -62
- package/dist/project-skills/remote-cache.js +0 -51
- package/dist/project-skills/validation.js +0 -19
- package/dist/recording/messages.js +0 -40
- package/dist/recording/project-digest.js +0 -85
- package/dist/recording/recorder.js +0 -293
- package/dist/recording/scenario.js +0 -50
- package/dist/skill-registry/client.js +0 -345
- package/dist/skill-registry/commands.js +0 -180
- package/dist/skill-registry/evaluation-client.js +0 -156
- package/dist/skill-registry/evaluation-commands.js +0 -174
- package/dist/skill-registry/messages.js +0 -177
- package/dist/skill-registry/package.js +0 -275
- package/dist/skill-registry/platform-package.js +0 -100
- package/dist/utils/environment-endpoints.js +0 -17
- package/dist/utils/error-diagnostics.js +0 -20
- package/dist/utils/tool-operation-journal.js +0 -124
- package/dist/utils/video-evidence-git.js +0 -81
- package/dist/video-replication/client.js +0 -234
- package/dist/video-replication/comparison-evidence.js +0 -149
- package/dist/video-replication/comparison-files.js +0 -57
- package/dist/video-replication/comparison-log.js +0 -72
- package/dist/video-replication/comparison-messages.js +0 -104
- package/dist/video-replication/comparison-output.js +0 -63
- package/dist/video-replication/comparison-preflight.js +0 -66
- package/dist/video-replication/comparison.js +0 -230
- package/dist/video-replication/diagnostics.js +0 -41
- package/dist/video-replication/evidence.js +0 -165
- package/dist/video-replication/media.js +0 -112
- package/dist/video-replication/messages.js +0 -97
- package/dist/workspace/messages.js +0 -67
- package/dist/workspace/transfer-client.js +0 -233
- package/dist/workspace/transfer-errors.js +0 -48
- package/dist/workspace-runtime/batch/content-changes.js +0 -30
- package/dist/workspace-runtime/batch/control.js +0 -86
- package/dist/workspace-runtime/batch/deliver.js +0 -173
- package/dist/workspace-runtime/batch/freeze.js +0 -101
- package/dist/workspace-runtime/batch/generate.js +0 -249
- package/dist/workspace-runtime/batch/git.js +0 -40
- package/dist/workspace-runtime/batch/occupancy.js +0 -8
- package/dist/workspace-runtime/batch/policy.js +0 -70
- package/dist/workspace-runtime/batch/prepare.js +0 -317
- package/dist/workspace-runtime/batch/processes.js +0 -72
- package/dist/workspace-runtime/batch/records.js +0 -113
- package/dist/workspace-runtime/batch/routes.js +0 -61
- package/dist/workspace-runtime/batch/source-candidate.js +0 -86
- package/dist/workspace-runtime/batch/source-capture.js +0 -146
- package/dist/workspace-runtime/batch/source-failure.js +0 -43
- package/dist/workspace-runtime/batch/source-publish.js +0 -130
- package/dist/workspace-runtime/codex/app-server.js +0 -1065
- package/dist/workspace-runtime/codex/compact.js +0 -46
- package/dist/workspace-runtime/codex/config-toml.js +0 -107
- package/dist/workspace-runtime/codex/delivery-tools.js +0 -144
- package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
- package/dist/workspace-runtime/codex/launcher-client.js +0 -177
- package/dist/workspace-runtime/codex/loopback.js +0 -146
- package/dist/workspace-runtime/codex/mcp-config.js +0 -39
- package/dist/workspace-runtime/codex/model-broker.js +0 -263
- package/dist/workspace-runtime/codex/native-adapter.js +0 -9
- package/dist/workspace-runtime/codex/permissions.js +0 -79
- package/dist/workspace-runtime/codex/thread-image.js +0 -38
- package/dist/workspace-runtime/codex/tool-response.js +0 -10
- package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
- package/dist/workspace-runtime/codex/ui-tools.js +0 -203
- package/dist/workspace-runtime/codex/work-mode.js +0 -15
- package/dist/workspace-runtime/main.js +0 -10
- package/dist/workspace-runtime/persistence/journal.js +0 -365
- package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
- package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
- package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
- package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
- package/dist/workspace-runtime/previews/diagnostics.js +0 -44
- package/dist/workspace-runtime/previews/output.js +0 -36
- package/dist/workspace-runtime/previews/publish.js +0 -274
- package/dist/workspace-runtime/previews/single-file.js +0 -43
- package/dist/workspace-runtime/processes/managed-writes.js +0 -69
- package/dist/workspace-runtime/serve.js +0 -343
- package/dist/workspace-runtime/server/accept-operation.js +0 -61
- package/dist/workspace-runtime/server/auth.js +0 -21
- package/dist/workspace-runtime/server/connectivity.js +0 -209
- package/dist/workspace-runtime/server/desktop-host.js +0 -429
- package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
- package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
- package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
- package/dist/workspace-runtime/server/desktop-preview.js +0 -189
- package/dist/workspace-runtime/server/dispatch.js +0 -1393
- package/dist/workspace-runtime/server/endpoints.js +0 -21
- package/dist/workspace-runtime/server/execution-group.js +0 -90
- package/dist/workspace-runtime/server/http.js +0 -1316
- package/dist/workspace-runtime/server/lock.js +0 -53
- package/dist/workspace-runtime/server/operation-record.js +0 -33
- package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
- package/dist/workspace-runtime/server/session-restore.js +0 -84
- package/dist/workspace-runtime/server/source-uploader.js +0 -138
- package/dist/workspace-runtime/server/submit-operation.js +0 -41
- package/dist/workspace-runtime/server/terminal-host.js +0 -366
- package/dist/workspace-runtime/server/types.js +0 -1
- package/dist/workspace-runtime/server/workspace-transfer.js +0 -168
- package/dist/workspace-runtime/verify-artifact.js +0 -59
- package/dist/workspace-runtime/workspaces/append-only-log.js +0 -62
- package/dist/workspace-runtime/workspaces/archive.js +0 -207
- package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
- package/dist/workspace-runtime/workspaces/artifact-files.js +0 -199
- package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
- package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
- package/dist/workspace-runtime/workspaces/asset-library-import.js +0 -366
- package/dist/workspace-runtime/workspaces/attachment-content.js +0 -73
- package/dist/workspace-runtime/workspaces/attachments.js +0 -185
- package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
- package/dist/workspace-runtime/workspaces/binary-content.js +0 -65
- package/dist/workspace-runtime/workspaces/binary-write.js +0 -112
- package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
- package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -115
- package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
- package/dist/workspace-runtime/workspaces/context-error.js +0 -2
- package/dist/workspace-runtime/workspaces/delivery-build.js +0 -331
- package/dist/workspace-runtime/workspaces/delivery-store.js +0 -168
- package/dist/workspace-runtime/workspaces/delivery.js +0 -64
- package/dist/workspace-runtime/workspaces/dependencies.js +0 -279
- package/dist/workspace-runtime/workspaces/developer-command.js +0 -98
- package/dist/workspace-runtime/workspaces/directories.js +0 -132
- package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
- package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
- package/dist/workspace-runtime/workspaces/directory-create.js +0 -57
- package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
- package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
- package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
- package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
- package/dist/workspace-runtime/workspaces/file-content.js +0 -48
- package/dist/workspace-runtime/workspaces/files-search.js +0 -116
- package/dist/workspace-runtime/workspaces/files.js +0 -150
- package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
- package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
- package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
- package/dist/workspace-runtime/workspaces/git.js +0 -670
- package/dist/workspace-runtime/workspaces/instructions.js +0 -56
- package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
- package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
- package/dist/workspace-runtime/workspaces/operation-log.js +0 -23
- package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
- package/dist/workspace-runtime/workspaces/parameters.js +0 -272
- package/dist/workspace-runtime/workspaces/prepare.js +0 -278
- package/dist/workspace-runtime/workspaces/registry.js +0 -251
- package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
- package/dist/workspace-runtime/workspaces/revisions.js +0 -31
- package/dist/workspace-runtime/workspaces/session-image.js +0 -104
- package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
- package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
- package/dist/workspace-runtime/workspaces/skills.js +0 -191
- package/dist/workspace-runtime/workspaces/transfer-quota.js +0 -69
- package/dist/workspace-runtime/workspaces/transfer.js +0 -471
- package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
- package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
- package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
- package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
- package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
- package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
- package/project-template-v2/.claude/agents/artist.md +0 -82
- package/project-template-v2/.claude/agents/developer.md +0 -153
- package/project-template-v2/.claude/agents/game-designer.md +0 -264
- package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
- package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
- package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
- package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
- package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
- package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
- package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
- package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
- package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
- package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
- package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
- package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
- package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
- package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
- package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
- package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
- package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
- package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
- package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
- package/project-template-v2/.claude/agents/reviewer.md +0 -75
- package/project-template-v2/.claude/agents/technical-artist.md +0 -86
- package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
- package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
- package/project-template-v2/.claude/settings.json +0 -33
- package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
- package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
- package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
- package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
- package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
- package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
- package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
- package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
- package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
- package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
- package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
- package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
- package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
- package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
- package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
- package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
- package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
- package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
- package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
- package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
- package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
- package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
- package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
- package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
- package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
- package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
- package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
- package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
- package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
- package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
- package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
- package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
- package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
- package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
- package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
- package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
- package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
- package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
- package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
- package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
- package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
- package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
- package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
- package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
- package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
- package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
- package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
- package/project-template-v2/.claude/snapshot.mjs +0 -263
- package/project-template-v2/.playcraft/skills.lock.json +0 -152
- package/project-template-v2/CLAUDE.md +0 -146
- package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
- package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
- package/project-template-v2/assets/bundles/.gitkeep +0 -0
- package/project-template-v2/assets/images/bg/.gitkeep +0 -0
- package/project-template-v2/assets/images/reference/.gitkeep +0 -0
- package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
- package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
- package/project-template-v2/assets/images/ui/.gitkeep +0 -0
- package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
- package/project-template-v2/assets/models/.gitkeep +0 -0
- package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
- package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
- package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
- package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
- package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
- package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
- package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
- package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
- package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
- package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
- package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
- package/project-template-v2/docs/project-state.json +0 -60
- package/project-template-v2/docs/project-state.md +0 -72
- package/project-template-v2/docs/standards/README.md +0 -225
- package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
- package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
- package/project-template-v2/docs/standards/artifacts/design.md +0 -22
- package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
- package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
- package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
- package/project-template-v2/game/index.ts +0 -18
- package/project-template-v2/globals.d.ts +0 -51
- package/project-template-v2/index.css +0 -34
- package/project-template-v2/index.html +0 -18
- package/project-template-v2/main.ts +0 -9
- package/project-template-v2/package.json +0 -46
- package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
- package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
- package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
- package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
- package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
- package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
- package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
- package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
- package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
- package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
- package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
- package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
- package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
- package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
- package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
- package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
- package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
- package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
- package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
- package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
- package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
- package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
- package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
- package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
- package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
- package/project-template-v2/skills/playable-record/SKILL.md +0 -140
- package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
- package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
- package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
- package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
- package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
- package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
- package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
- package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
- package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
- package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
- package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
- package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
- package/project-template-v2/tsconfig.json +0 -20
- package/project-template-v2/vite.config.ts +0 -27
- package/project-templates/batch-locks/phaser.yaml +0 -922
- package/project-templates/batch-locks/threejs.yaml +0 -978
- package/project-templates/empty/AGENTS.md +0 -41
- package/project-templates/empty/gitignore +0 -33
|
@@ -1,366 +0,0 @@
|
|
|
1
|
-
import { batchDirectoryHeld } from '../batch/occupancy.js';
|
|
2
|
-
import { createRequire } from 'node:module';
|
|
3
|
-
import { randomUUID } from 'node:crypto';
|
|
4
|
-
import { lstat } from 'node:fs/promises';
|
|
5
|
-
import { StringDecoder } from 'node:string_decoder';
|
|
6
|
-
import { WebSocketServer } from 'ws';
|
|
7
|
-
import { appendTerminalOutput, createTerminalOutputLog, decodeTerminalBytes, runtimeError, terminalClientFrameSchema, terminalOutputSince, } from '@playcraft/common/cloud-workspace/runtime';
|
|
8
|
-
import { resolveWorkspaceFile } from '../workspaces/files.js';
|
|
9
|
-
import { sessionWorkspaceRoot } from '../workspaces/registry.js';
|
|
10
|
-
import { startLauncherProcess } from '../codex/launcher-client.js';
|
|
11
|
-
import { controlTokenMatches, extractControlToken } from './auth.js';
|
|
12
|
-
const require = createRequire(import.meta.url);
|
|
13
|
-
const commands = new WeakMap();
|
|
14
|
-
const hosts = new WeakMap();
|
|
15
|
-
export function setTerminalCommand(state, command) {
|
|
16
|
-
commands.set(state, command);
|
|
17
|
-
}
|
|
18
|
-
export function terminalHost(state) {
|
|
19
|
-
let host = hosts.get(state);
|
|
20
|
-
if (!host) {
|
|
21
|
-
host = new TerminalHost(state);
|
|
22
|
-
hosts.set(state, host);
|
|
23
|
-
}
|
|
24
|
-
return host;
|
|
25
|
-
}
|
|
26
|
-
export function disposeTerminalHost(state) {
|
|
27
|
-
hosts.get(state)?.dispose();
|
|
28
|
-
hosts.delete(state);
|
|
29
|
-
}
|
|
30
|
-
export class TerminalHost {
|
|
31
|
-
state;
|
|
32
|
-
disposed = false;
|
|
33
|
-
sessions = new Map();
|
|
34
|
-
spawning = new Map();
|
|
35
|
-
restored;
|
|
36
|
-
attempted = new Set();
|
|
37
|
-
closing = new Set();
|
|
38
|
-
stops = new Map();
|
|
39
|
-
confirmed = new Set();
|
|
40
|
-
sockets = new WebSocketServer({ noServer: true });
|
|
41
|
-
constructor(state) {
|
|
42
|
-
this.state = state;
|
|
43
|
-
// An absent in-memory session cannot prove a restored terminal's old process group stopped.
|
|
44
|
-
this.restored = new Set((state.journal?.listTerminals?.() ?? []).map(terminal => terminal.terminalId));
|
|
45
|
-
}
|
|
46
|
-
async handleUpgrade(request, socket, head) {
|
|
47
|
-
const url = new URL(request.url ?? '/', 'http://127.0.0.1');
|
|
48
|
-
const match = /^\/runtime\/terminals\/([^/]+)\/connect$/.exec(url.pathname);
|
|
49
|
-
if (!match || !controlTokenMatches(this.state.config.controlToken, extractControlToken(request.headers))) {
|
|
50
|
-
rejectUpgrade(socket, 401, runtimeError('unauthenticated', 'control_token_required'));
|
|
51
|
-
return;
|
|
52
|
-
}
|
|
53
|
-
if (this.disposed || this.state.journal.destroyed()) {
|
|
54
|
-
rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'runtime_destroyed'));
|
|
55
|
-
return;
|
|
56
|
-
}
|
|
57
|
-
let terminalId;
|
|
58
|
-
try {
|
|
59
|
-
terminalId = decodeURIComponent(match[1]);
|
|
60
|
-
}
|
|
61
|
-
catch {
|
|
62
|
-
rejectUpgrade(socket, 404, { error: 'terminal_not_found' });
|
|
63
|
-
return;
|
|
64
|
-
}
|
|
65
|
-
const terminal = this.state.journal.getTerminal(terminalId);
|
|
66
|
-
if (!terminal) {
|
|
67
|
-
rejectUpgrade(socket, 404, { error: 'terminal_not_found' });
|
|
68
|
-
return;
|
|
69
|
-
}
|
|
70
|
-
if (await batchDirectoryHeld(this.state, terminal.workspaceId, terminal.directoryName)) {
|
|
71
|
-
rejectUpgrade(socket, 409, { error: 'batch_workspace_readonly' });
|
|
72
|
-
return;
|
|
73
|
-
}
|
|
74
|
-
if (terminal.status === 'destroyed') {
|
|
75
|
-
rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'terminal_destroyed'));
|
|
76
|
-
return;
|
|
77
|
-
}
|
|
78
|
-
if (this.closing.has(terminalId) || this.restored.has(terminalId) && !this.sessions.has(terminalId)) {
|
|
79
|
-
rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'terminal_stop_unconfirmed'));
|
|
80
|
-
return;
|
|
81
|
-
}
|
|
82
|
-
let session = this.sessions.get(terminal.terminalId);
|
|
83
|
-
if (!session) {
|
|
84
|
-
try {
|
|
85
|
-
let pending = this.spawning.get(terminal.terminalId);
|
|
86
|
-
if (!pending) {
|
|
87
|
-
pending = terminalDirectory(this.state, terminal).then((cwd) => this.spawn(terminal, cwd))
|
|
88
|
-
.finally(() => this.spawning.delete(terminal.terminalId));
|
|
89
|
-
this.spawning.set(terminal.terminalId, pending);
|
|
90
|
-
}
|
|
91
|
-
session = await pending;
|
|
92
|
-
}
|
|
93
|
-
catch {
|
|
94
|
-
rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'pty_unavailable'));
|
|
95
|
-
return;
|
|
96
|
-
}
|
|
97
|
-
}
|
|
98
|
-
if (this.disposed || this.state.journal.destroyed() || this.closing.has(terminalId) || this.state.journal.getTerminal(terminalId)?.status === 'destroyed') {
|
|
99
|
-
if (!this.closing.has(terminalId))
|
|
100
|
-
this.revoke(terminalId, 'terminal_destroyed');
|
|
101
|
-
rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'terminal_destroyed'));
|
|
102
|
-
return;
|
|
103
|
-
}
|
|
104
|
-
const active = session;
|
|
105
|
-
this.sockets.handleUpgrade(request, socket, head, (ws) => this.attach(active, ws));
|
|
106
|
-
}
|
|
107
|
-
destroy(terminalId) {
|
|
108
|
-
const pending = this.stops.get(terminalId);
|
|
109
|
-
if (pending)
|
|
110
|
-
return pending;
|
|
111
|
-
this.closing.add(terminalId);
|
|
112
|
-
const stopped = (async () => {
|
|
113
|
-
await this.spawning.get(terminalId);
|
|
114
|
-
const session = this.sessions.get(terminalId);
|
|
115
|
-
if (session)
|
|
116
|
-
await session.stop();
|
|
117
|
-
else if (!this.confirmed.has(terminalId) && (this.restored.has(terminalId) || this.attempted.has(terminalId)))
|
|
118
|
-
throw new Error('terminal_stop_unconfirmed');
|
|
119
|
-
const terminal = this.state.journal.getTerminal(terminalId);
|
|
120
|
-
if (!terminal)
|
|
121
|
-
throw new Error('terminal_not_found');
|
|
122
|
-
const destroyed = terminal.status === 'destroyed' ? terminal : await this.state.journal.putTerminal({
|
|
123
|
-
...terminal, status: 'destroyed', destroyedAt: new Date().toISOString(),
|
|
124
|
-
});
|
|
125
|
-
this.confirmed.add(terminalId);
|
|
126
|
-
this.revoke(terminalId, 'terminal_destroyed');
|
|
127
|
-
this.closing.delete(terminalId);
|
|
128
|
-
return destroyed;
|
|
129
|
-
})().finally(() => this.stops.delete(terminalId));
|
|
130
|
-
this.stops.set(terminalId, stopped);
|
|
131
|
-
return stopped;
|
|
132
|
-
}
|
|
133
|
-
revoke(terminalId, reason) {
|
|
134
|
-
const session = this.sessions.get(terminalId);
|
|
135
|
-
if (!session)
|
|
136
|
-
return;
|
|
137
|
-
this.sessions.delete(terminalId);
|
|
138
|
-
const frame = { type: 'revoked', reason };
|
|
139
|
-
for (const listener of session.listeners)
|
|
140
|
-
listener(frame);
|
|
141
|
-
session.listeners.clear();
|
|
142
|
-
try {
|
|
143
|
-
session.pty.kill();
|
|
144
|
-
}
|
|
145
|
-
catch {
|
|
146
|
-
/* the process may already have exited */
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
dispose() {
|
|
150
|
-
this.disposed = true;
|
|
151
|
-
for (const terminalId of [...this.sessions.keys()])
|
|
152
|
-
this.revoke(terminalId, 'runtime_destroyed');
|
|
153
|
-
this.sockets.close();
|
|
154
|
-
}
|
|
155
|
-
async spawn(terminal, cwd) {
|
|
156
|
-
if (this.disposed)
|
|
157
|
-
throw new Error('pty_unavailable');
|
|
158
|
-
if (this.state.config.workspaceMode === 'multi' || process.env.PLAYCRAFT_LAUNCHER_SOCKET
|
|
159
|
-
|| process.getuid?.() === 1500) {
|
|
160
|
-
// User shells require the root launcher's fixed development account, even when an
|
|
161
|
-
// alternative command is installed for local tests. Never fall back to the control user.
|
|
162
|
-
const socketPath = process.env.PLAYCRAFT_LAUNCHER_SOCKET;
|
|
163
|
-
if (!socketPath)
|
|
164
|
-
throw new Error('pty_unavailable');
|
|
165
|
-
this.attempted.add(terminal.terminalId);
|
|
166
|
-
const child = await startLauncherProcess({ socketPath, processId: `terminal-${randomUUID()}`,
|
|
167
|
-
runtimeEpoch: this.state.runtimeEpoch, cwd, argv: [], env: {}, terminal: { cols: 80, rows: 24 } });
|
|
168
|
-
if (this.disposed) {
|
|
169
|
-
await child.stop();
|
|
170
|
-
throw new Error('pty_unavailable');
|
|
171
|
-
}
|
|
172
|
-
const session = { terminalId: terminal.terminalId, streamId: randomUUID(), log: createTerminalOutputLog(), listeners: new Set(),
|
|
173
|
-
stop: () => child.stop(),
|
|
174
|
-
pty: { write: (data) => { child.stdin?.write(data); }, resize: child.resize,
|
|
175
|
-
kill: () => { void child.stop().catch(() => undefined); } } };
|
|
176
|
-
const decoder = new StringDecoder('utf8');
|
|
177
|
-
child.stdout?.on('data', (data) => { const text = decoder.write(data); if (text)
|
|
178
|
-
publish(session, text); });
|
|
179
|
-
child.onExit((code) => {
|
|
180
|
-
const tail = decoder.end();
|
|
181
|
-
if (tail)
|
|
182
|
-
publish(session, tail);
|
|
183
|
-
const stopped = code === undefined ? Promise.resolve(false) : child.stop().then(() => true, () => false);
|
|
184
|
-
void stopped.then(confirmed => this.exited(terminal.terminalId, session, confirmed ? code : undefined)).catch(() => undefined);
|
|
185
|
-
});
|
|
186
|
-
this.sessions.set(terminal.terminalId, session);
|
|
187
|
-
return session;
|
|
188
|
-
}
|
|
189
|
-
const pty = require('node-pty');
|
|
190
|
-
const command = commands.get(this.state) ?? defaultShell();
|
|
191
|
-
let finishExit;
|
|
192
|
-
let didExit = false;
|
|
193
|
-
const knownExit = new Promise(resolve => { finishExit = () => { didExit = true; resolve(); }; });
|
|
194
|
-
this.attempted.add(terminal.terminalId);
|
|
195
|
-
const session = {
|
|
196
|
-
terminalId: terminal.terminalId,
|
|
197
|
-
streamId: randomUUID(),
|
|
198
|
-
log: createTerminalOutputLog(),
|
|
199
|
-
listeners: new Set(),
|
|
200
|
-
pty: pty.spawn(command.file, command.args, {
|
|
201
|
-
name: 'xterm-256color',
|
|
202
|
-
cols: 80,
|
|
203
|
-
rows: 24,
|
|
204
|
-
cwd,
|
|
205
|
-
env: shellEnv(command.file, cwd),
|
|
206
|
-
}),
|
|
207
|
-
stop: async () => {
|
|
208
|
-
if (!didExit)
|
|
209
|
-
session.pty.kill();
|
|
210
|
-
let timer;
|
|
211
|
-
try {
|
|
212
|
-
await Promise.race([knownExit, new Promise((_resolve, reject) => {
|
|
213
|
-
timer = setTimeout(() => reject(new Error('terminal_stop_unconfirmed')), 3000);
|
|
214
|
-
})]);
|
|
215
|
-
}
|
|
216
|
-
finally {
|
|
217
|
-
clearTimeout(timer);
|
|
218
|
-
}
|
|
219
|
-
},
|
|
220
|
-
};
|
|
221
|
-
const local = session.pty;
|
|
222
|
-
local.onData((data) => publish(session, data));
|
|
223
|
-
local.onExit(({ exitCode, signal }) => { finishExit(); void this.exited(terminal.terminalId, session, exitCode, signal).catch(() => undefined); });
|
|
224
|
-
this.sessions.set(terminal.terminalId, session);
|
|
225
|
-
return session;
|
|
226
|
-
}
|
|
227
|
-
async exited(terminalId, session, code, signal) {
|
|
228
|
-
session.exited = { code: code ?? null, ...(signal === undefined ? {} : { signal: String(signal) }) };
|
|
229
|
-
try {
|
|
230
|
-
if (code !== undefined) {
|
|
231
|
-
const terminal = this.state.journal.getTerminal(terminalId);
|
|
232
|
-
if (terminal && terminal.status !== 'destroyed')
|
|
233
|
-
await this.state.journal.putTerminal({
|
|
234
|
-
...terminal, status: 'destroyed', destroyedAt: new Date().toISOString(),
|
|
235
|
-
});
|
|
236
|
-
if (terminal)
|
|
237
|
-
this.confirmed.add(terminalId);
|
|
238
|
-
}
|
|
239
|
-
}
|
|
240
|
-
finally {
|
|
241
|
-
for (const listener of session.listeners)
|
|
242
|
-
listener(exitFrame(session));
|
|
243
|
-
}
|
|
244
|
-
}
|
|
245
|
-
attach(session, ws) {
|
|
246
|
-
let open = true;
|
|
247
|
-
let resumed = false;
|
|
248
|
-
let cursor = 0;
|
|
249
|
-
const send = (frame) => {
|
|
250
|
-
if (open && ws.readyState === ws.OPEN)
|
|
251
|
-
ws.send(JSON.stringify(frame));
|
|
252
|
-
};
|
|
253
|
-
const listener = (frame) => {
|
|
254
|
-
if (!resumed)
|
|
255
|
-
return;
|
|
256
|
-
if (frame.type === 'output') {
|
|
257
|
-
const end = frame.offset + decodeTerminalBytes(frame.data).length;
|
|
258
|
-
if (end <= cursor)
|
|
259
|
-
return;
|
|
260
|
-
cursor = Math.max(cursor, end);
|
|
261
|
-
}
|
|
262
|
-
send(frame);
|
|
263
|
-
};
|
|
264
|
-
session.listeners.add(listener);
|
|
265
|
-
ws.on('message', (raw) => {
|
|
266
|
-
let body;
|
|
267
|
-
try {
|
|
268
|
-
body = JSON.parse(String(raw));
|
|
269
|
-
}
|
|
270
|
-
catch {
|
|
271
|
-
return;
|
|
272
|
-
}
|
|
273
|
-
const parsed = terminalClientFrameSchema.safeParse(body);
|
|
274
|
-
if (!parsed.success || (session.exited || this.closing.has(session.terminalId)) && parsed.data.type !== 'resume')
|
|
275
|
-
return;
|
|
276
|
-
const frame = parsed.data;
|
|
277
|
-
if (frame.type === 'resume') {
|
|
278
|
-
if (frame.streamId && frame.streamId !== session.streamId) {
|
|
279
|
-
send({ type: 'reset', streamId: session.streamId, offset: session.log.end });
|
|
280
|
-
cursor = session.log.end;
|
|
281
|
-
resumed = true;
|
|
282
|
-
if (session.exited)
|
|
283
|
-
send(exitFrame(session));
|
|
284
|
-
return;
|
|
285
|
-
}
|
|
286
|
-
const since = terminalOutputSince(session.log, frame.offset);
|
|
287
|
-
if (since.gap)
|
|
288
|
-
send({ type: 'gap', streamId: session.streamId, offset: since.offset });
|
|
289
|
-
for (const item of since.frames) {
|
|
290
|
-
send({ type: 'output', streamId: session.streamId, offset: item.offset, data: item.data });
|
|
291
|
-
}
|
|
292
|
-
cursor = session.log.end;
|
|
293
|
-
resumed = true;
|
|
294
|
-
if (session.exited)
|
|
295
|
-
send(exitFrame(session));
|
|
296
|
-
return;
|
|
297
|
-
}
|
|
298
|
-
if (!resumed)
|
|
299
|
-
return;
|
|
300
|
-
if (frame.type === 'resize') {
|
|
301
|
-
session.pty.resize(frame.cols, frame.rows);
|
|
302
|
-
return;
|
|
303
|
-
}
|
|
304
|
-
session.pty.write(Buffer.from(decodeTerminalBytes(frame.data)).toString('utf8'));
|
|
305
|
-
});
|
|
306
|
-
const detach = () => {
|
|
307
|
-
open = false;
|
|
308
|
-
session.listeners.delete(listener);
|
|
309
|
-
};
|
|
310
|
-
ws.on('close', detach);
|
|
311
|
-
ws.on('error', detach);
|
|
312
|
-
}
|
|
313
|
-
}
|
|
314
|
-
function publish(session, text) {
|
|
315
|
-
const before = session.log.end;
|
|
316
|
-
session.log = appendTerminalOutput(session.log, text);
|
|
317
|
-
const since = terminalOutputSince(session.log, before);
|
|
318
|
-
for (const item of since.frames) {
|
|
319
|
-
const frame = {
|
|
320
|
-
type: 'output',
|
|
321
|
-
streamId: session.streamId,
|
|
322
|
-
offset: item.offset,
|
|
323
|
-
data: item.data,
|
|
324
|
-
};
|
|
325
|
-
for (const listener of session.listeners)
|
|
326
|
-
listener(frame);
|
|
327
|
-
}
|
|
328
|
-
}
|
|
329
|
-
function exitFrame(session) {
|
|
330
|
-
return {
|
|
331
|
-
type: 'exit',
|
|
332
|
-
streamId: session.streamId,
|
|
333
|
-
code: session.exited?.code ?? null,
|
|
334
|
-
...(session.exited?.signal ? { signal: session.exited.signal } : {}),
|
|
335
|
-
};
|
|
336
|
-
}
|
|
337
|
-
async function terminalDirectory(state, terminal) {
|
|
338
|
-
const root = await sessionWorkspaceRoot(state, terminal.workspaceId, terminal.directoryName);
|
|
339
|
-
if (!terminal.cwd)
|
|
340
|
-
return root;
|
|
341
|
-
const resolved = await resolveWorkspaceFile(root, terminal.cwd);
|
|
342
|
-
const stat = await lstat(resolved);
|
|
343
|
-
if (!stat.isDirectory() || stat.isSymbolicLink())
|
|
344
|
-
throw new Error('pty_unavailable');
|
|
345
|
-
return resolved;
|
|
346
|
-
}
|
|
347
|
-
function defaultShell() {
|
|
348
|
-
const shell = process.env.SHELL;
|
|
349
|
-
const file = shell && shell.startsWith('/') ? shell : '/bin/sh';
|
|
350
|
-
return { file, args: ['-i'] };
|
|
351
|
-
}
|
|
352
|
-
function shellEnv(file, cwd) {
|
|
353
|
-
return {
|
|
354
|
-
PATH: process.env.PATH ?? '/usr/bin:/bin',
|
|
355
|
-
HOME: process.env.HOME ?? cwd,
|
|
356
|
-
TERM: 'xterm-256color',
|
|
357
|
-
LANG: process.env.LANG ?? 'C.UTF-8',
|
|
358
|
-
SHELL: file,
|
|
359
|
-
};
|
|
360
|
-
}
|
|
361
|
-
function rejectUpgrade(socket, status, body) {
|
|
362
|
-
const payload = JSON.stringify(body);
|
|
363
|
-
const title = status === 401 ? 'Unauthorized' : status === 404 ? 'Not Found' : 'Conflict';
|
|
364
|
-
socket.write(`HTTP/1.1 ${status} ${title}\r\ncontent-type: application/json; charset=utf-8\r\ncontent-length: ${Buffer.byteLength(payload)}\r\nconnection: close\r\n\r\n${payload}`);
|
|
365
|
-
socket.destroy();
|
|
366
|
-
}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export {};
|
|
@@ -1,168 +0,0 @@
|
|
|
1
|
-
import { createReadStream, createWriteStream } from 'node:fs';
|
|
2
|
-
import { mkdtemp, rm, stat } from 'node:fs/promises';
|
|
3
|
-
import { tmpdir } from 'node:os';
|
|
4
|
-
import { join } from 'node:path';
|
|
5
|
-
import { Readable, Transform } from 'node:stream';
|
|
6
|
-
import { pipeline } from 'node:stream/promises';
|
|
7
|
-
import { applyWorkspaceTransfer, createWorkspaceTransfer, inspectWorkspaceTransfer, inspectWorkspaceTree, WorkspaceTransferError } from '../workspaces/transfer.js';
|
|
8
|
-
import { assertTransferDiskSpace, checkWorkspaceTransferQuota, transferDiskBudget } from '../workspaces/transfer-quota.js';
|
|
9
|
-
import { revisionScope, sessionWorkspaceRoot, workspaceContainerRoot } from '../workspaces/registry.js';
|
|
10
|
-
import { workspaceDirectoryOccupied } from '../workspaces/directory-maintenance.js';
|
|
11
|
-
import { publishSourceEvents } from './dispatch.js';
|
|
12
|
-
export async function handleWorkspaceTransfer(state, request, response, url) {
|
|
13
|
-
const workspaceId = url.searchParams.get('workspaceId') ?? undefined;
|
|
14
|
-
const directoryName = url.searchParams.get('directoryName') ?? 'basic';
|
|
15
|
-
const root = await sessionWorkspaceRoot(state, workspaceId, directoryName);
|
|
16
|
-
const controller = new AbortController();
|
|
17
|
-
const abort = () => controller.abort();
|
|
18
|
-
const close = () => { if (!response.writableEnded)
|
|
19
|
-
abort(); };
|
|
20
|
-
request.once('aborted', abort);
|
|
21
|
-
response.once('close', close);
|
|
22
|
-
let temporary;
|
|
23
|
-
try {
|
|
24
|
-
const directories = directoryName === 'root'
|
|
25
|
-
? [...new Set(['root', 'basic', ...(state.journal.getWorkspace(workspaceId ?? '')?.directories ?? []).map(item => item.directoryName)])].sort()
|
|
26
|
-
: [...new Set(['root', directoryName])].sort();
|
|
27
|
-
const assertAvailable = async () => {
|
|
28
|
-
controller.signal.throwIfAborted();
|
|
29
|
-
if (state.journal.destroyed())
|
|
30
|
-
throw new WorkspaceTransferError('runtime_destroyed');
|
|
31
|
-
for (const directory of directories) {
|
|
32
|
-
if (await workspaceDirectoryOccupied(state, workspaceId ?? 'workspace', directory))
|
|
33
|
-
throw new WorkspaceTransferError('workspace_transfer_busy');
|
|
34
|
-
}
|
|
35
|
-
};
|
|
36
|
-
const quotaRoot = await workspaceContainerRoot(state, workspaceId);
|
|
37
|
-
if (request.method === 'GET' && url.searchParams.get('preflight') === '1') {
|
|
38
|
-
const integer = (key) => {
|
|
39
|
-
const value = url.searchParams.get(key) ?? '';
|
|
40
|
-
if (!/^\d+$/.test(value) || !Number.isSafeInteger(Number(value)))
|
|
41
|
-
throw new WorkspaceTransferError('invalid_workspace_transfer');
|
|
42
|
-
return Number(value);
|
|
43
|
-
};
|
|
44
|
-
const expectedTree = url.searchParams.get('expectedTree') ?? '';
|
|
45
|
-
if (!/^[a-f0-9]{40,64}$/.test(expectedTree))
|
|
46
|
-
throw new WorkspaceTransferError('invalid_workspace_transfer');
|
|
47
|
-
const incoming = { bytes: integer('contentBytes'), files: integer('fileCount') };
|
|
48
|
-
await assertAvailable();
|
|
49
|
-
const targetTree = url.searchParams.get('targetTree');
|
|
50
|
-
if (targetTree !== null && !/^[a-f0-9]{40,64}$/.test(targetTree))
|
|
51
|
-
throw new WorkspaceTransferError('invalid_workspace_transfer');
|
|
52
|
-
const current = await inspectWorkspaceTree(root, { signal: controller.signal });
|
|
53
|
-
if (current.tree === targetTree) {
|
|
54
|
-
writeJson(response, 200, { protocolVersion: 2, alreadyApplied: true, tree: current.tree });
|
|
55
|
-
return;
|
|
56
|
-
}
|
|
57
|
-
if (current.tree !== expectedTree)
|
|
58
|
-
throw new WorkspaceTransferError('workspace_transfer_conflict');
|
|
59
|
-
const quota = await checkWorkspaceTransferQuota(quotaRoot, current, incoming, state.config.workspaceStorageQuotaBytes);
|
|
60
|
-
await assertTransferDiskSpace(tmpdir(), current.bytes * 2 + incoming.bytes * 2);
|
|
61
|
-
writeJson(response, 200, { protocolVersion: 2, quota, contentBytes: incoming.bytes, fileCount: incoming.files });
|
|
62
|
-
return;
|
|
63
|
-
}
|
|
64
|
-
if (request.method === 'GET') {
|
|
65
|
-
const current = await inspectWorkspaceTransfer(root, { signal: controller.signal });
|
|
66
|
-
await assertTransferDiskSpace(tmpdir(), current.bytes * 3);
|
|
67
|
-
const snapshot = await createWorkspaceTransfer(root, { signal: controller.signal });
|
|
68
|
-
try {
|
|
69
|
-
controller.signal.throwIfAborted();
|
|
70
|
-
response.writeHead(200, { 'content-type': 'application/octet-stream', 'cache-control': 'private, no-store',
|
|
71
|
-
'content-length': (await stat(snapshot.bundlePath)).size, 'x-content-type-options': 'nosniff',
|
|
72
|
-
'x-playcraft-workspace-tree': snapshot.tree, 'x-playcraft-workspace-head': snapshot.head,
|
|
73
|
-
'x-playcraft-workspace-content-bytes': snapshot.stats.bytes, 'x-playcraft-workspace-file-count': snapshot.stats.files });
|
|
74
|
-
await pipeline(createReadStream(snapshot.bundlePath), response, { signal: controller.signal });
|
|
75
|
-
}
|
|
76
|
-
finally {
|
|
77
|
-
await snapshot.cleanup();
|
|
78
|
-
}
|
|
79
|
-
return;
|
|
80
|
-
}
|
|
81
|
-
const expectedTree = request.headers['x-playcraft-workspace-tree'];
|
|
82
|
-
if (typeof expectedTree !== 'string' || !/^[a-f0-9]{40,64}$/.test(expectedTree))
|
|
83
|
-
throw new WorkspaceTransferError('invalid_workspace_transfer');
|
|
84
|
-
const rawLength = request.headers['content-length'];
|
|
85
|
-
const declaredLength = rawLength === undefined ? undefined : Number(rawLength);
|
|
86
|
-
if (rawLength !== undefined && (typeof rawLength !== 'string' || !/^\d+$/.test(rawLength) || !Number.isSafeInteger(declaredLength)))
|
|
87
|
-
throw new WorkspaceTransferError('invalid_workspace_transfer');
|
|
88
|
-
await assertAvailable();
|
|
89
|
-
const disk = await transferDiskBudget(tmpdir());
|
|
90
|
-
if (declaredLength !== undefined)
|
|
91
|
-
await assertTransferDiskSpace(tmpdir(), declaredLength);
|
|
92
|
-
temporary = await mkdtemp(join(tmpdir(), 'playcraft-upload-'));
|
|
93
|
-
const bundlePath = join(temporary, 'incoming.bundle');
|
|
94
|
-
let size = 0, lastProbe = 0;
|
|
95
|
-
const guard = new Transform({ transform(chunk, _encoding, callback) {
|
|
96
|
-
size += chunk.length;
|
|
97
|
-
if (size > disk.budget) {
|
|
98
|
-
callback(new WorkspaceTransferError('workspace_transfer_disk_full', { metric: 'transferBytes', actual: size, limit: disk.budget }));
|
|
99
|
-
return;
|
|
100
|
-
}
|
|
101
|
-
if (size - lastProbe < 16 * 1024 * 1024) {
|
|
102
|
-
callback(null, chunk);
|
|
103
|
-
return;
|
|
104
|
-
}
|
|
105
|
-
lastProbe = size;
|
|
106
|
-
assertTransferDiskSpace(temporary, chunk.length).then(() => callback(null, chunk), error => callback(error));
|
|
107
|
-
} });
|
|
108
|
-
await pipeline(Readable.from(request.iterator({ destroyOnReturn: false })), guard, createWriteStream(bundlePath, { flags: 'wx', mode: 0o600 }), { signal: controller.signal });
|
|
109
|
-
if (!size || (declaredLength !== undefined && size !== declaredLength))
|
|
110
|
-
throw new WorkspaceTransferError('invalid_workspace_transfer');
|
|
111
|
-
const lockKeys = [...new Set([...directories.map(name => `directory:${workspaceId}:${name}`),
|
|
112
|
-
...directories.map(name => `workspace:${revisionScope(state, workspaceId, name) ?? 'single'}`)])];
|
|
113
|
-
const locked = async (index) => index < lockKeys.length
|
|
114
|
-
? state.journal.exclusive(lockKeys[index], () => locked(index + 1))
|
|
115
|
-
: apply();
|
|
116
|
-
const apply = async () => {
|
|
117
|
-
await assertAvailable();
|
|
118
|
-
const current = await inspectWorkspaceTransfer(root, { signal: controller.signal });
|
|
119
|
-
await assertTransferDiskSpace(tmpdir(), current.bytes * 2);
|
|
120
|
-
return applyWorkspaceTransfer(root, bundlePath, expectedTree, {
|
|
121
|
-
signal: controller.signal,
|
|
122
|
-
validateSnapshot: async (incoming, actualCurrent) => {
|
|
123
|
-
await checkWorkspaceTransferQuota(quotaRoot, actualCurrent, incoming, state.config.workspaceStorageQuotaBytes);
|
|
124
|
-
await assertTransferDiskSpace(tmpdir(), incoming.bytes);
|
|
125
|
-
},
|
|
126
|
-
});
|
|
127
|
-
};
|
|
128
|
-
const result = await locked(0);
|
|
129
|
-
if (result.changedPaths.length > 0) {
|
|
130
|
-
const groups = new Map([[directoryName, result.changedPaths]]);
|
|
131
|
-
if (directoryName === 'root')
|
|
132
|
-
for (const path of result.changedPaths) {
|
|
133
|
-
const [directory, ...parts] = path.split('/');
|
|
134
|
-
if (directory && directories.includes(directory) && parts.length)
|
|
135
|
-
groups.set(directory, [...(groups.get(directory) ?? []), parts.join('/')]);
|
|
136
|
-
}
|
|
137
|
-
const events = [];
|
|
138
|
-
for (const [directory, paths] of groups)
|
|
139
|
-
events.push(await state.journal.allocateSourceEvent({
|
|
140
|
-
runtimeId: state.config.runtimeId, generation: state.config.generation, runtimeEpoch: state.runtimeEpoch,
|
|
141
|
-
workspaceId, type: 'files.changed', occurredAt: new Date().toISOString(), payload: { workspaceId, directoryName: directory, paths },
|
|
142
|
-
}));
|
|
143
|
-
await publishSourceEvents(state, events);
|
|
144
|
-
}
|
|
145
|
-
writeJson(response, 200, result);
|
|
146
|
-
}
|
|
147
|
-
catch (error) {
|
|
148
|
-
if (response.headersSent)
|
|
149
|
-
response.destroy(error instanceof Error ? error : undefined);
|
|
150
|
-
else if (!controller.signal.aborted) {
|
|
151
|
-
const code = error instanceof WorkspaceTransferError ? error.code
|
|
152
|
-
: error.code === 'ENOSPC' ? 'workspace_transfer_disk_full' : 'workspace_transfer_failed';
|
|
153
|
-
const status = code === 'workspace_transfer_quota_exceeded' ? 413 : code === 'workspace_transfer_disk_full' ? 507
|
|
154
|
-
: code === 'invalid_workspace_transfer' ? 400 : code.includes('timeout') ? 504 : code === 'workspace_transfer_storage_unavailable' ? 503 : 409;
|
|
155
|
-
writeJson(response, status, { error: code, ...(error instanceof WorkspaceTransferError && error.details ? { details: error.details } : {}) });
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
|
-
finally {
|
|
159
|
-
request.off('aborted', abort);
|
|
160
|
-
response.off('close', close);
|
|
161
|
-
if (temporary)
|
|
162
|
-
await rm(temporary, { recursive: true, force: true });
|
|
163
|
-
}
|
|
164
|
-
}
|
|
165
|
-
function writeJson(response, status, body) {
|
|
166
|
-
response.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'private, no-store' });
|
|
167
|
-
response.end(JSON.stringify(body));
|
|
168
|
-
}
|
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
import assert from 'node:assert/strict';
|
|
2
|
-
import { randomUUID } from 'node:crypto';
|
|
3
|
-
import { readFile, mkdtemp, rm } from 'node:fs/promises';
|
|
4
|
-
import { createRequire } from 'node:module';
|
|
5
|
-
import { tmpdir } from 'node:os';
|
|
6
|
-
import { dirname, join, resolve } from 'node:path';
|
|
7
|
-
import { fileURLToPath } from 'node:url';
|
|
8
|
-
import { batchSourceRemoteRef, parseSandboxRuntimeConfig } from '@playcraft/common/cloud-workspace/runtime';
|
|
9
|
-
import { createLoopbackNativeAdapter } from './codex/loopback.js';
|
|
10
|
-
import { startWorkspaceRuntime } from './serve.js';
|
|
11
|
-
async function dependencyVersion(name, entry) {
|
|
12
|
-
let directory = dirname(createRequire(import.meta.url).resolve(entry));
|
|
13
|
-
for (;;) {
|
|
14
|
-
const metadata = await readFile(join(directory, 'package.json'), 'utf8').then(JSON.parse).catch(() => undefined);
|
|
15
|
-
if (metadata?.name === name)
|
|
16
|
-
return metadata.version;
|
|
17
|
-
const parent = dirname(directory);
|
|
18
|
-
if (parent === directory)
|
|
19
|
-
throw new Error(`package_metadata_missing:${name}`);
|
|
20
|
-
directory = parent;
|
|
21
|
-
}
|
|
22
|
-
}
|
|
23
|
-
/** Starts only an isolated temporary runtime; never reads or changes an existing workspace. */
|
|
24
|
-
export async function verifyRuntimeArtifact(expectedVersion) {
|
|
25
|
-
assert.match(expectedVersion, /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/);
|
|
26
|
-
const metadata = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), 'utf8'));
|
|
27
|
-
assert.equal(metadata.version, expectedVersion, 'command package version differs from the release target');
|
|
28
|
-
assert.equal(await dependencyVersion('@playcraft/common', '@playcraft/common/cloud-workspace/runtime'), expectedVersion);
|
|
29
|
-
assert.equal(await dependencyVersion('@playcraft/build', '@playcraft/build'), expectedVersion);
|
|
30
|
-
const batchId = randomUUID();
|
|
31
|
-
assert.equal(batchSourceRemoteRef(batchId), `refs/tags/playcraft/batch/${batchId}/source`, 'installed shared library lacks standard tag references for source snapshots');
|
|
32
|
-
const directory = await mkdtemp(join(tmpdir(), 'playcraft-artifact-verify-'));
|
|
33
|
-
let runtime;
|
|
34
|
-
try {
|
|
35
|
-
const config = parseSandboxRuntimeConfig({
|
|
36
|
-
protocolMajor: 1, protocolMinor: 0, environment: 'artifact-verification',
|
|
37
|
-
runtimeId: randomUUID(), userId: 'artifact-verification', generation: 1, runtimeEpoch: 0,
|
|
38
|
-
workspaceMode: 'multi', workspaceRoot: join(directory, 'workspaces'), stateDir: join(directory, 'state'),
|
|
39
|
-
publicBaseUrl: 'http://127.0.0.1:9', controlToken: randomUUID(), cliVersion: expectedVersion,
|
|
40
|
-
listen: { host: '127.0.0.1', port: 0 },
|
|
41
|
-
});
|
|
42
|
-
runtime = await startWorkspaceRuntime(config, { nativeAdapter: createLoopbackNativeAdapter() });
|
|
43
|
-
const response = await fetch(`${runtime.url}/runtime/identity`, {
|
|
44
|
-
headers: { authorization: `Bearer ${config.controlToken}` }, signal: AbortSignal.timeout(10_000),
|
|
45
|
-
});
|
|
46
|
-
assert.equal(response.status, 200, 'built runtime identity is unavailable');
|
|
47
|
-
const identity = await response.json();
|
|
48
|
-
assert.equal(identity.runtimeId, config.runtimeId);
|
|
49
|
-
assert.equal(identity.batchSourceFreezeRevision, 2, 'built runtime lacks the required batch source freeze implementation');
|
|
50
|
-
}
|
|
51
|
-
finally {
|
|
52
|
-
await runtime?.close();
|
|
53
|
-
await rm(directory, { recursive: true, force: true });
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
|
|
57
|
-
await verifyRuntimeArtifact(process.argv[2] ?? '');
|
|
58
|
-
console.log('Runtime artifact verified: batchSourceFreezeRevision=2');
|
|
59
|
-
}
|
|
@@ -1,62 +0,0 @@
|
|
|
1
|
-
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import { constants } from 'node:fs';
|
|
3
|
-
import { mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
|
|
4
|
-
import { dirname } from 'node:path';
|
|
5
|
-
/**
|
|
6
|
-
* One append-only log file with a hard byte cap. When the cap is crossed the file is atomically
|
|
7
|
-
* replaced with a truncation notice plus the newest bytes, so readers never see a half write.
|
|
8
|
-
*/
|
|
9
|
-
export class AppendOnlyLog {
|
|
10
|
-
path;
|
|
11
|
-
maxBytes;
|
|
12
|
-
truncatedNotice;
|
|
13
|
-
constructor(path, maxBytes, truncatedNotice = '[playcraft] log truncated; showing the tail\n') {
|
|
14
|
-
this.path = path;
|
|
15
|
-
this.maxBytes = maxBytes;
|
|
16
|
-
this.truncatedNotice = truncatedNotice;
|
|
17
|
-
}
|
|
18
|
-
async append(chunk) {
|
|
19
|
-
if (!chunk)
|
|
20
|
-
return;
|
|
21
|
-
await mkdir(dirname(this.path), { recursive: true, mode: 0o700 });
|
|
22
|
-
const handle = await open(this.path, constants.O_WRONLY | constants.O_CREAT | constants.O_APPEND | constants.O_NOFOLLOW, 0o600);
|
|
23
|
-
try {
|
|
24
|
-
await handle.write(Buffer.from(chunk));
|
|
25
|
-
}
|
|
26
|
-
finally {
|
|
27
|
-
await handle.close();
|
|
28
|
-
}
|
|
29
|
-
const info = await stat(this.path);
|
|
30
|
-
if (info.size <= this.maxBytes)
|
|
31
|
-
return;
|
|
32
|
-
const content = await readFile(this.path);
|
|
33
|
-
const notice = Buffer.from(this.truncatedNotice);
|
|
34
|
-
const tail = content.subarray(Math.max(0, content.length - (this.maxBytes - notice.length)));
|
|
35
|
-
const temporary = `${this.path}.${randomUUID()}.tmp`;
|
|
36
|
-
try {
|
|
37
|
-
await writeFile(temporary, Buffer.concat([notice, tail]), { mode: 0o600 });
|
|
38
|
-
await rename(temporary, this.path);
|
|
39
|
-
}
|
|
40
|
-
catch (error) {
|
|
41
|
-
await rm(temporary, { force: true }).catch(() => undefined);
|
|
42
|
-
throw error;
|
|
43
|
-
}
|
|
44
|
-
}
|
|
45
|
-
async read(offset = 0) {
|
|
46
|
-
let content;
|
|
47
|
-
try {
|
|
48
|
-
content = await readFile(this.path);
|
|
49
|
-
}
|
|
50
|
-
catch (error) {
|
|
51
|
-
if (error.code === 'ENOENT')
|
|
52
|
-
return { text: '', size: 0, offset: 0 };
|
|
53
|
-
throw error;
|
|
54
|
-
}
|
|
55
|
-
const start = Math.min(Math.max(0, offset), content.length);
|
|
56
|
-
return { text: content.subarray(start).toString('utf8'), size: content.length, offset: start };
|
|
57
|
-
}
|
|
58
|
-
async size() {
|
|
59
|
-
const info = await stat(this.path).catch(() => undefined);
|
|
60
|
-
return info?.isFile() ? info.size : 0;
|
|
61
|
-
}
|
|
62
|
-
}
|