@playcraft/cli 0.1.33 → 0.1.35-prod
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 -56
- package/dist/agent/local-backend.js +1 -1
- package/dist/cli-root-help.js +0 -2
- package/dist/commands/build.js +4 -9
- 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 -2
- package/dist/commands/tools-3d.js +0 -11
- package/dist/commands/tools-generation.js +109 -68
- package/dist/commands/tools-image-context.js +23 -0
- package/dist/commands/tools.js +2 -2
- package/dist/config.js +4 -59
- package/dist/index.js +3 -36
- 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 -185
- package/dist/utils/image-asset-context.js +105 -0
- package/dist/utils/playcraft-http-client.js +4 -6
- package/package.json +5 -14
- package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
- package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +105 -44
- 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 +36 -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 +105 -44
- 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 +36 -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 +105 -44
- 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 +36 -39
- package/dist/auth/account-activation.js +0 -157
- package/dist/auth/messages.js +0 -30
- package/dist/commands/platform-skills.generated.js +0 -19
- package/dist/commands/playable.js +0 -53
- package/dist/commands/tools-batch.js +0 -87
- package/dist/commands/video.js +0 -111
- package/dist/commands/workspace-runtime.js +0 -54
- package/dist/commands/workspace.js +0 -35
- 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/utils/environment-endpoints.js +0 -17
- 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 -222
- 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 -216
- package/dist/video-replication/evidence.js +0 -165
- package/dist/video-replication/media.js +0 -111
- package/dist/video-replication/messages.js +0 -89
- package/dist/workspace/messages.js +0 -35
- package/dist/workspace/transfer-client.js +0 -174
- package/dist/workspace-runtime/codex/app-server.js +0 -965
- package/dist/workspace-runtime/codex/compact.js +0 -46
- package/dist/workspace-runtime/codex/config-toml.js +0 -107
- 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 -70
- 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 -355
- 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 -1096
- package/dist/workspace-runtime/previews/output.js +0 -36
- package/dist/workspace-runtime/previews/publish.js +0 -262
- package/dist/workspace-runtime/previews/single-file.js +0 -43
- package/dist/workspace-runtime/processes/managed-writes.js +0 -69
- package/dist/workspace-runtime/production/contracts.js +0 -17
- package/dist/workspace-runtime/production/controller.js +0 -207
- package/dist/workspace-runtime/production/dependencies.js +0 -60
- package/dist/workspace-runtime/production/native.js +0 -203
- package/dist/workspace-runtime/production/processes.js +0 -86
- package/dist/workspace-runtime/production/save-command.js +0 -35
- package/dist/workspace-runtime/production/source-copy.js +0 -91
- package/dist/workspace-runtime/production/stages.js +0 -205
- package/dist/workspace-runtime/production/storage.js +0 -60
- package/dist/workspace-runtime/serve.js +0 -207
- package/dist/workspace-runtime/server/auth.js +0 -21
- package/dist/workspace-runtime/server/connectivity.js +0 -201
- 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 -1174
- package/dist/workspace-runtime/server/endpoints.js +0 -19
- package/dist/workspace-runtime/server/execution-group.js +0 -85
- package/dist/workspace-runtime/server/http.js +0 -1127
- package/dist/workspace-runtime/server/lock.js +0 -53
- package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
- 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 -99
- 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 -197
- package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
- package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
- package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
- package/dist/workspace-runtime/workspaces/attachments.js +0 -181
- package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
- package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
- package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
- package/dist/workspace-runtime/workspaces/composer-context.js +0 -125
- package/dist/workspace-runtime/workspaces/context-error.js +0 -2
- package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
- package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
- package/dist/workspace-runtime/workspaces/directories.js +0 -123
- 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-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 -40
- package/dist/workspace-runtime/workspaces/files-search.js +0 -116
- package/dist/workspace-runtime/workspaces/files.js +0 -120
- 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 -658
- 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/parameters.js +0 -272
- package/dist/workspace-runtime/workspaces/prepare.js +0 -264
- package/dist/workspace-runtime/workspaces/registry.js +0 -236
- package/dist/workspace-runtime/workspaces/revisions.js +0 -31
- package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -91
- package/dist/workspace-runtime/workspaces/skills.js +0 -189
- package/dist/workspace-runtime/workspaces/transfer.js +0 -288
- package/dist/workspace-runtime/workspaces/turn-changes.js +0 -72
- 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 -39
- package/project-templates/empty/gitignore +0 -33
|
@@ -1,205 +0,0 @@
|
|
|
1
|
-
import { execFile } from 'node:child_process';
|
|
2
|
-
import { createHash } from 'node:crypto';
|
|
3
|
-
import { lstat, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises';
|
|
4
|
-
import { dirname, join } from 'node:path';
|
|
5
|
-
import { promisify } from 'node:util';
|
|
6
|
-
import { batchBaselineSnapshotSchema } from '@playcraft/common/cloud-workspace/runtime';
|
|
7
|
-
import { checkoutBatchCommit, freezeBatchCommit } from '../workspaces/batch-commit.js';
|
|
8
|
-
import { grantWorkspaceTraversal, openDirectoryToDevelopment } from '../workspaces/directory-access.js';
|
|
9
|
-
import { registerWorkspaceDirectory } from '../workspaces/directories.js';
|
|
10
|
-
import { workspaceContainerRoot, workspaceRoot, workspaceSessions } from '../workspaces/registry.js';
|
|
11
|
-
import { excludeFromGit, settleDependencyInstalls } from '../workspaces/dependencies.js';
|
|
12
|
-
import { resolveProductionDependencies, verifyProductionDependencyLocks } from './dependencies.js';
|
|
13
|
-
import { productionLocalCommitCommand } from './save-command.js';
|
|
14
|
-
import { productionOutputStore, verifyProductionLease } from './storage.js';
|
|
15
|
-
import { runProductionCommand } from './processes.js';
|
|
16
|
-
import { runProductionNative } from './native.js';
|
|
17
|
-
import { classifyPreviewOutput, findExternalLocalReferences } from '../previews/single-file.js';
|
|
18
|
-
import { copyProductionSource } from './source-copy.js';
|
|
19
|
-
import { workspaceDirectoryOccupied } from '../workspaces/directory-maintenance.js';
|
|
20
|
-
import { ensureWorkspaceSkills } from '../workspaces/skills.js';
|
|
21
|
-
const execute = promisify(execFile);
|
|
22
|
-
const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
|
|
23
|
-
const hash = (body) => createHash('sha256').update(body).digest('hex');
|
|
24
|
-
const record = (value) => value && typeof value === 'object' ? value : {};
|
|
25
|
-
export async function executeProductionStage(state, input, processRecord, track) {
|
|
26
|
-
await verifyProductionLease(input);
|
|
27
|
-
const store = productionOutputStore(input);
|
|
28
|
-
const stage = input.stage;
|
|
29
|
-
const workspaceId = input.task.workspaceId;
|
|
30
|
-
const resultId = String(input.payload.resultVersionId ?? input.task.payload.resultVersionId ?? input.task.attemptId);
|
|
31
|
-
const sourceDirectoryName = String(input.payload.sourceDirectoryName ?? input.task.payload.sourceDirectoryName ?? 'basic');
|
|
32
|
-
if (input.task.payload.sourceDirectoryName !== undefined && input.payload.sourceDirectoryName !== undefined
|
|
33
|
-
&& input.task.payload.sourceDirectoryName !== input.payload.sourceDirectoryName)
|
|
34
|
-
throw new Error('production_source_directory_mismatch');
|
|
35
|
-
const previous = (name) => input.stages?.find(value => value.stage === name && value.status === 'completed')?.result;
|
|
36
|
-
const run = async (cwd, command, env, trusted = false) => {
|
|
37
|
-
const outcome = await runProductionCommand(state, { processId: `production-${input.task.attemptId}-${stage}`, cwd, command, env, trusted,
|
|
38
|
-
timeoutMs: 10 * 60_000, record: processRecord });
|
|
39
|
-
if (!outcome.stopped || outcome.code === undefined)
|
|
40
|
-
throw new Error('production_process_unknown');
|
|
41
|
-
if (outcome.code !== 0)
|
|
42
|
-
throw new Error(`production_${stage}_failed`);
|
|
43
|
-
return outcome.output;
|
|
44
|
-
};
|
|
45
|
-
const git = async (root, ...args) => (await execute('git', ['-c', 'core.hooksPath=/dev/null', '-c', 'core.fsmonitor=false', '-C', root, ...args], {
|
|
46
|
-
timeout: 20_000, maxBuffer: 1024 * 1024, env: { PATH: process.env.PATH, HOME: state.config.stateDir, GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1' },
|
|
47
|
-
})).stdout.trim();
|
|
48
|
-
if (stage === 'capture-source') {
|
|
49
|
-
if (input.directoryName === 'basic' || input.directoryName === sourceDirectoryName)
|
|
50
|
-
throw new Error('production_source_directory_mismatch');
|
|
51
|
-
const authority = record(input.payload.workspace);
|
|
52
|
-
if (authority.directoryName !== input.directoryName || authority.workspaceId !== workspaceId
|
|
53
|
-
|| typeof authority.remixId !== 'string' || typeof authority.branchName !== 'string' || typeof authority.repositoryUrl !== 'string')
|
|
54
|
-
throw new Error('production_source_directory_mismatch');
|
|
55
|
-
const { remixId, branchName, repositoryUrl } = authority;
|
|
56
|
-
await settleDependencyInstalls(state);
|
|
57
|
-
return state.journal.exclusive(`directory:${workspaceId}:${sourceDirectoryName}`, async () => {
|
|
58
|
-
if (await workspaceDirectoryOccupied(state, workspaceId, sourceDirectoryName)
|
|
59
|
-
|| workspaceSessions(state, workspaceId, sourceDirectoryName).some(session => session.turnBlock === 'uncertain' || ['starting', 'running', 'waiting_for_user'].includes(session.turnStatus ?? '')))
|
|
60
|
-
throw new Error('production_source_busy');
|
|
61
|
-
const source = await workspaceRoot(state, workspaceId, sourceDirectoryName);
|
|
62
|
-
const container = await workspaceContainerRoot(state, workspaceId);
|
|
63
|
-
const destination = join(container, input.directoryName);
|
|
64
|
-
const developmentGroup = (await lstat(state.config.workspaceRoot)).gid;
|
|
65
|
-
const snapshot = await copyProductionSource({ source, destination, branchName, repositoryUrl });
|
|
66
|
-
await ensureWorkspaceSkills(destination, join(state.config.stateDir, 'skill-artifacts'));
|
|
67
|
-
await openDirectoryToDevelopment(destination, developmentGroup);
|
|
68
|
-
await grantWorkspaceTraversal(container, developmentGroup);
|
|
69
|
-
await state.journal.exclusive(`workspace:${workspaceId}`, async () => {
|
|
70
|
-
const binding = state.journal.getWorkspace(workspaceId);
|
|
71
|
-
await state.journal.putWorkspace({ ...binding, directories: [...(binding.directories ?? []).filter(value => value.directoryName !== input.directoryName),
|
|
72
|
-
{ workspaceId, directoryName: input.directoryName, remixId, branchName, sourceCommit: snapshot.commitHash, status: 'ready' }] });
|
|
73
|
-
});
|
|
74
|
-
return { sourceSnapshot: snapshot, commitHash: snapshot.commitHash };
|
|
75
|
-
});
|
|
76
|
-
}
|
|
77
|
-
if (stage === 'prepare' && input.directoryName !== 'basic' && (input.payload.baseline ?? input.task.payload.baseline)) {
|
|
78
|
-
const baseline = record(input.payload.baseline ?? input.task.payload.baseline);
|
|
79
|
-
const authority = record(input.payload.workspace);
|
|
80
|
-
const sourceCommit = baseline.commitHash;
|
|
81
|
-
if (typeof sourceCommit !== 'string')
|
|
82
|
-
throw new Error('production_approved_commit_required');
|
|
83
|
-
const directory = { workspaceId, directoryName: input.directoryName,
|
|
84
|
-
remixId: String(authority.remixId), branchName: String(authority.branchName), sourceCommit };
|
|
85
|
-
await registerWorkspaceDirectory(state, directory, state.acceptedLeaseFence, sourceDirectoryName);
|
|
86
|
-
}
|
|
87
|
-
const root = await workspaceRoot(state, workspaceId, input.directoryName);
|
|
88
|
-
if (stage === 'prepare') {
|
|
89
|
-
await settleDependencyInstalls(state);
|
|
90
|
-
if (!(await lstat(join(root, 'package.json')).catch(() => undefined)))
|
|
91
|
-
return { prepared: true, directoryName: input.directoryName, emptySource: true };
|
|
92
|
-
const policy = await resolveProductionDependencies(root).catch(error => {
|
|
93
|
-
if (!(input.payload.baseline ?? input.task.payload.baseline) && error instanceof Error
|
|
94
|
-
&& error.message === 'production_dependency_lock_required')
|
|
95
|
-
return undefined;
|
|
96
|
-
throw error;
|
|
97
|
-
});
|
|
98
|
-
if (!policy)
|
|
99
|
-
return { prepared: true, directoryName: input.directoryName, dependencyRepairRequired: true };
|
|
100
|
-
await run(root, process.env.PLAYCRAFT_PRODUCTION_INSTALL_COMMAND ?? 'pnpm install --frozen-lockfile --store-dir /var/cache/playcraft/pnpm-store --ignore-scripts');
|
|
101
|
-
await verifyProductionDependencyLocks(root, policy);
|
|
102
|
-
return { prepared: true, directoryName: input.directoryName };
|
|
103
|
-
}
|
|
104
|
-
if (stage === 'generate') {
|
|
105
|
-
await runProductionNative(state, input, root, processRecord, track);
|
|
106
|
-
await resolveProductionDependencies(root);
|
|
107
|
-
return { generated: true };
|
|
108
|
-
}
|
|
109
|
-
if (stage === 'save') {
|
|
110
|
-
const binding = state.journal.getWorkspace(workspaceId);
|
|
111
|
-
const branch = input.directoryName === 'basic' ? binding.branchName : binding.directories?.find(value => value.directoryName === input.directoryName)?.branchName;
|
|
112
|
-
if ((input.git && input.git.branchName !== branch) || await git(root, 'symbolic-ref', '--short', 'HEAD') !== branch)
|
|
113
|
-
throw new Error('production_git_binding_mismatch');
|
|
114
|
-
await run(root, 'chmod -R u+rwX,g+rwX .').catch(() => undefined);
|
|
115
|
-
await excludeFromGit(root);
|
|
116
|
-
await excludeFromGit(root, '/.env*');
|
|
117
|
-
await excludeFromGit(root, '/.playcraft-temp/');
|
|
118
|
-
await excludeFromGit(root, '/.playcraft-preview-out/');
|
|
119
|
-
await git(root, 'config', 'user.name', 'PlayCraft');
|
|
120
|
-
await git(root, 'config', 'user.email', 'playcraft@localhost');
|
|
121
|
-
const env = { GIT_TERMINAL_PROMPT: '0', GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1' };
|
|
122
|
-
await run(root, productionLocalCommitCommand(), env, true);
|
|
123
|
-
const commitHash = await git(root, 'rev-parse', 'HEAD');
|
|
124
|
-
const snapshot = await freezeBatchCommit({ source: { workspaceId, root }, commitHash, snapshotId: `${input.task.attemptId}-save` });
|
|
125
|
-
return { snapshot, saved: { attemptId: input.task.attemptId, resultVersionId: resultId, workspaceId, sourceDigest: snapshot.checksum, commitHash, pushedCommitHash: commitHash } };
|
|
126
|
-
}
|
|
127
|
-
if (stage === 'freeze') {
|
|
128
|
-
const saved = record(previous('save')?.saved);
|
|
129
|
-
if (typeof saved.commitHash !== 'string')
|
|
130
|
-
throw new Error('production_saved_commit_required');
|
|
131
|
-
const snapshot = await freezeBatchCommit({ source: { workspaceId, root }, commitHash: saved.commitHash, snapshotId: `${input.task.attemptId}-freeze` });
|
|
132
|
-
const baseline = batchBaselineSnapshotSchema.parse({ batchId: input.task.batchId, projectId: String(input.payload.projectId ?? input.task.payload.projectId),
|
|
133
|
-
snapshotId: snapshot.snapshotId, sourceWorkspaceId: snapshot.sourceWorkspaceId, commitHash: snapshot.commitHash, checksum: snapshot.checksum,
|
|
134
|
-
sourceVersion: snapshot.sourceVersion, engine: String(input.payload.engine ?? input.task.payload.engine), skillLockDigest: snapshot.skillLockDigest, frozenAt: snapshot.frozenAt });
|
|
135
|
-
return { snapshot, baseline };
|
|
136
|
-
}
|
|
137
|
-
if (stage === 'build') {
|
|
138
|
-
const saved = record(input.payload.saved ?? previous('save')?.saved);
|
|
139
|
-
const snapshot = (previous('freeze')?.snapshot ?? previous('save')?.snapshot);
|
|
140
|
-
if (!snapshot || snapshot.commitHash !== saved.commitHash || snapshot.checksum !== saved.sourceDigest)
|
|
141
|
-
throw new Error('production_saved_snapshot_mismatch');
|
|
142
|
-
const destination = join(root, '.playcraft-temp', `production-${input.task.attemptId}`);
|
|
143
|
-
const removeDestination = async () => {
|
|
144
|
-
try {
|
|
145
|
-
await rm(destination, { recursive: true, force: true });
|
|
146
|
-
}
|
|
147
|
-
catch {
|
|
148
|
-
await run(destination, 'chmod -R u+rwX,g+rwX .').catch(() => undefined);
|
|
149
|
-
await rm(destination, { recursive: true, force: true });
|
|
150
|
-
}
|
|
151
|
-
};
|
|
152
|
-
await excludeFromGit(root, '/.playcraft-temp/');
|
|
153
|
-
await removeDestination();
|
|
154
|
-
try {
|
|
155
|
-
await checkoutBatchCommit({ source: { workspaceId, root }, frozen: snapshot, destination });
|
|
156
|
-
await openDirectoryToDevelopment(destination, (await lstat(state.config.workspaceRoot)).gid);
|
|
157
|
-
const policy = await resolveProductionDependencies(destination);
|
|
158
|
-
await run(destination, process.env.PLAYCRAFT_PRODUCTION_INSTALL_COMMAND ?? 'pnpm install --frozen-lockfile --store-dir /var/cache/playcraft/pnpm-store --ignore-scripts');
|
|
159
|
-
await verifyProductionDependencyLocks(destination, policy);
|
|
160
|
-
const output = join(destination, '.production-html');
|
|
161
|
-
const command = process.env.PLAYCRAFT_PRODUCTION_BUILD_COMMAND ?? 'playcraft build --mode full --platform playcraft --format html';
|
|
162
|
-
await run(destination, `${command} --output ${quote(output)} .`);
|
|
163
|
-
await verifyProductionDependencyLocks(destination, policy);
|
|
164
|
-
const entries = await readdir(output, { withFileTypes: true });
|
|
165
|
-
const single = classifyPreviewOutput(entries.map(entry => ({ name: entry.name, kind: entry.isFile() ? 'file' : entry.isDirectory() ? 'dir' : 'symlink' })));
|
|
166
|
-
if (!single.ok)
|
|
167
|
-
throw new Error('production_preview_not_single_file');
|
|
168
|
-
const path = join(output, single.entry);
|
|
169
|
-
if (!(await lstat(path)).isFile())
|
|
170
|
-
throw new Error('production_preview_invalid');
|
|
171
|
-
const body = await readFile(path);
|
|
172
|
-
if (findExternalLocalReferences(body.toString()).length)
|
|
173
|
-
throw new Error('production_preview_external_reference');
|
|
174
|
-
const outputDigest = hash(body), outputKey = `workspaces/${workspaceId}/production/${input.task.attemptId}/${outputDigest}.html`;
|
|
175
|
-
await store.put(outputKey, body);
|
|
176
|
-
return { outputKey, outputDigest, build: { attemptId: input.task.attemptId, resultVersionId: resultId, workspaceId,
|
|
177
|
-
sourceDigest: snapshot.checksum, commitHash: snapshot.commitHash, buildId: `${input.task.attemptId}-build`, succeeded: true } };
|
|
178
|
-
}
|
|
179
|
-
finally {
|
|
180
|
-
await removeDestination();
|
|
181
|
-
}
|
|
182
|
-
}
|
|
183
|
-
if (stage === 'preview') {
|
|
184
|
-
const built = previous('build');
|
|
185
|
-
if (typeof built?.outputKey !== 'string' || typeof built.outputDigest !== 'string')
|
|
186
|
-
throw new Error('production_build_required');
|
|
187
|
-
const body = await store.get(built.outputKey);
|
|
188
|
-
if (hash(body) !== built.outputDigest)
|
|
189
|
-
throw new Error('production_preview_digest_mismatch');
|
|
190
|
-
const previewPath = join(root, '.playcraft-temp', `${input.task.attemptId}.html`);
|
|
191
|
-
await mkdir(dirname(previewPath), { recursive: true });
|
|
192
|
-
await writeFile(previewPath, body);
|
|
193
|
-
try {
|
|
194
|
-
const browser = process.env.PLAYCRAFT_PRODUCTION_PREVIEW_COMMAND ?? 'chromium --headless --no-sandbox --disable-gpu --virtual-time-budget=1000 --dump-dom';
|
|
195
|
-
const opened = await run(root, `${browser} ${quote(`file://${previewPath}`)}`);
|
|
196
|
-
if (!/<\/?html[\s>]/i.test(opened))
|
|
197
|
-
throw new Error('production_preview_not_opened');
|
|
198
|
-
return { opened: true, outputDigest: built.outputDigest };
|
|
199
|
-
}
|
|
200
|
-
finally {
|
|
201
|
-
await rm(previewPath, { force: true });
|
|
202
|
-
}
|
|
203
|
-
}
|
|
204
|
-
throw new Error('invalid_production_stage');
|
|
205
|
-
}
|
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
const taskUrl = (input) => `${input.callbackUrl.replace(/\/+$/, '')}/internal/cloud-production/tasks/${input.task.taskId}`;
|
|
2
|
-
/** Build output travels through the Runtime that leased the task; engineering files travel through Git. */
|
|
3
|
-
export function productionOutputStore(input) {
|
|
4
|
-
const object = (key) => `${taskUrl(input)}/objects/${encodeURIComponent(key)}`;
|
|
5
|
-
const headers = { authorization: `Bearer ${input.runnerToken}`, 'x-playcraft-object-client': 'cli' };
|
|
6
|
-
return {
|
|
7
|
-
async get(key) {
|
|
8
|
-
const response = await fetch(object(key), { headers, redirect: 'error', signal: AbortSignal.timeout(60_000) });
|
|
9
|
-
if (response.status === 404)
|
|
10
|
-
throw new Error('object_missing');
|
|
11
|
-
if (!response.ok)
|
|
12
|
-
throw new Error('object_get_failed');
|
|
13
|
-
return Buffer.from(await response.arrayBuffer());
|
|
14
|
-
},
|
|
15
|
-
async put(key, body) {
|
|
16
|
-
const response = await fetch(object(key), { method: 'PUT', body: new Uint8Array(body), redirect: 'error', signal: AbortSignal.timeout(60_000),
|
|
17
|
-
headers: { ...headers, 'content-type': 'application/octet-stream' } });
|
|
18
|
-
if (!response.ok)
|
|
19
|
-
throw new Error(response.status === 409 ? 'object_conflict' : 'object_put_failed');
|
|
20
|
-
},
|
|
21
|
-
};
|
|
22
|
-
}
|
|
23
|
-
export async function verifyProductionLease(input) {
|
|
24
|
-
let status;
|
|
25
|
-
let reason;
|
|
26
|
-
try {
|
|
27
|
-
const response = await fetch(`${taskUrl(input)}/runner`, {
|
|
28
|
-
headers: { authorization: `Bearer ${input.runnerToken}` }, redirect: 'error', signal: AbortSignal.timeout(10_000),
|
|
29
|
-
});
|
|
30
|
-
status = response.status;
|
|
31
|
-
if (!response.ok) {
|
|
32
|
-
const value = await response.json().catch(() => undefined);
|
|
33
|
-
const body = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
|
|
34
|
-
reason = [body.reason, body.code, body.message, body.error]
|
|
35
|
-
.find((value) => typeof value === 'string' && /^[a-z0-9_]{1,128}$/.test(value)
|
|
36
|
-
&& !value.includes(input.runnerToken));
|
|
37
|
-
throw new Error('production_lease_unavailable');
|
|
38
|
-
}
|
|
39
|
-
reason = 'production_lease_invalid_response';
|
|
40
|
-
const { task } = await response.json();
|
|
41
|
-
if (!task || task.taskId !== input.task.taskId || task.attemptId !== input.task.attemptId || task.leaseOwner !== input.lease.owner || task.leaseFence !== input.lease.fence || task.status !== 'running' || task.cancelRequested) {
|
|
42
|
-
reason = 'production_lease_mismatch';
|
|
43
|
-
throw new Error('production_lease_unavailable');
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
catch (error) {
|
|
47
|
-
const cause = error instanceof Error ? error.cause : undefined;
|
|
48
|
-
const causeCode = cause && typeof cause === 'object' && 'code' in cause && typeof cause.code === 'string'
|
|
49
|
-
&& /^[A-Za-z0-9_]{1,64}$/.test(cause.code) ? cause.code : undefined;
|
|
50
|
-
// Callback diagnostics retain machine codes only; responses and credentials stay private.
|
|
51
|
-
try {
|
|
52
|
-
console.error(JSON.stringify({ event: 'production.lease_verification_failed', taskId: input.task.taskId,
|
|
53
|
-
attemptId: input.task.attemptId, workspaceId: input.task.workspaceId, directoryName: input.directoryName,
|
|
54
|
-
stage: input.stage, leaseFence: input.lease.fence, status, reason,
|
|
55
|
-
errorType: error instanceof Error && /^[A-Za-z0-9_]{1,64}$/.test(error.name) ? error.name : 'UnknownError', causeCode }));
|
|
56
|
-
}
|
|
57
|
-
catch { /* Diagnostics must preserve the original failure. */ }
|
|
58
|
-
throw error;
|
|
59
|
-
}
|
|
60
|
-
}
|
|
@@ -1,207 +0,0 @@
|
|
|
1
|
-
import { closeCliCredentials } from './workspaces/cli-credentials.js';
|
|
2
|
-
import { randomUUID } from 'node:crypto';
|
|
3
|
-
import { mkdir } from 'node:fs/promises';
|
|
4
|
-
import { createServer } from 'node:http';
|
|
5
|
-
import { INCOMPATIBLE_EXIT_CODE, negotiateProtocol, } from '@playcraft/common/cloud-workspace/runtime';
|
|
6
|
-
import { RuntimeJournal } from './persistence/journal.js';
|
|
7
|
-
import { createCodexAppServerAdapter } from './codex/app-server.js';
|
|
8
|
-
import { createLoopbackNativeAdapter } from './codex/loopback.js';
|
|
9
|
-
import { attachNativeCollector } from './server/dispatch.js';
|
|
10
|
-
import { handleRuntimeRequest } from './server/http.js';
|
|
11
|
-
import { desktopHost, disposeDesktopHost } from './server/desktop-host.js';
|
|
12
|
-
import { disposeTerminalHost, terminalHost } from './server/terminal-host.js';
|
|
13
|
-
import { handleExecutionGroupCrash } from './server/execution-group.js';
|
|
14
|
-
import { RuntimeProcessLock } from './server/lock.js';
|
|
15
|
-
import { probeGitBinary } from './workspaces/git.js';
|
|
16
|
-
import { WorkspaceGitCredentialBroker } from './workspaces/git-credential-broker.js';
|
|
17
|
-
import { WorkspaceModelBroker } from './codex/model-broker.js';
|
|
18
|
-
import { recoverInterruptedPreviews } from './previews/publish.js';
|
|
19
|
-
import { recoverInterruptedInstalls } from './workspaces/dependencies.js';
|
|
20
|
-
import { loadWorkspaceSkillArtifact } from './workspaces/skill-artifact-loader.js';
|
|
21
|
-
import { workspaceContextFromRoot } from './workspaces/registry.js';
|
|
22
|
-
import { observeWorkspaceArtifacts } from './workspaces/artifact-events.js';
|
|
23
|
-
import { loadWorkspaceMcpConfig } from './codex/mcp-config.js';
|
|
24
|
-
export async function startWorkspaceRuntime(config, options = {}) {
|
|
25
|
-
process.env.PLAYCRAFT_SKIP_UPDATE_CHECK = '1';
|
|
26
|
-
const negotiated = negotiateProtocol(config);
|
|
27
|
-
if (!negotiated.ok) {
|
|
28
|
-
const error = Object.assign(new Error('protocol_incompatible'), {
|
|
29
|
-
code: 'protocol_incompatible',
|
|
30
|
-
exitCode: INCOMPATIBLE_EXIT_CODE,
|
|
31
|
-
});
|
|
32
|
-
throw error;
|
|
33
|
-
}
|
|
34
|
-
const lock = new RuntimeProcessLock(config.stateDir);
|
|
35
|
-
lock.acquire();
|
|
36
|
-
let journal;
|
|
37
|
-
let gitCredentials;
|
|
38
|
-
try {
|
|
39
|
-
journal = new RuntimeJournal(config.stateDir);
|
|
40
|
-
await journal.load();
|
|
41
|
-
const previousEpoch = journal.storedRuntimeEpoch();
|
|
42
|
-
const previousGroup = journal.executionGroup();
|
|
43
|
-
const previousIdentityMatches = journal.epochsSnapshot().some((epoch) => epoch.runtime_id === config.runtimeId && epoch.generation === config.generation && epoch.runtime_epoch === previousEpoch);
|
|
44
|
-
await recoverInterruptedInstalls(journal);
|
|
45
|
-
await recoverInterruptedPreviews(journal);
|
|
46
|
-
await mkdir(config.workspaceRoot, { recursive: true, mode: 0o700 });
|
|
47
|
-
const state = {
|
|
48
|
-
config: { ...config, protocolMinor: negotiated.protocolMinor },
|
|
49
|
-
configPath: options.configPath,
|
|
50
|
-
journal,
|
|
51
|
-
acceptedLeaseFence: journal.acceptedLeaseFence(),
|
|
52
|
-
gitAvailable: await probeGitBinary(),
|
|
53
|
-
native: options.nativeAdapter,
|
|
54
|
-
runtimeEpoch: Math.max(config.runtimeEpoch, journal.storedRuntimeEpoch() ?? 0),
|
|
55
|
-
executionQueue: Promise.resolve(),
|
|
56
|
-
instanceToken: randomUUID(),
|
|
57
|
-
};
|
|
58
|
-
const native = state.native ??= defaultNativeAdapter(state);
|
|
59
|
-
await journal.bindRuntime({
|
|
60
|
-
runtimeId: config.runtimeId,
|
|
61
|
-
generation: config.generation,
|
|
62
|
-
runtimeEpoch: state.runtimeEpoch,
|
|
63
|
-
});
|
|
64
|
-
if (config.workspaceMode === 'multi') {
|
|
65
|
-
gitCredentials = state.gitCredentials = new WorkspaceGitCredentialBroker(state);
|
|
66
|
-
await gitCredentials.start();
|
|
67
|
-
}
|
|
68
|
-
const stopArtifactObserver = observeWorkspaceArtifacts(state);
|
|
69
|
-
attachNativeCollector(state);
|
|
70
|
-
native?.onUnexpectedExit?.((event) => {
|
|
71
|
-
void handleExecutionGroupCrash(state, event.pid);
|
|
72
|
-
});
|
|
73
|
-
try {
|
|
74
|
-
await native?.start?.();
|
|
75
|
-
const group = native?.executionProcess?.();
|
|
76
|
-
if (group) {
|
|
77
|
-
let previousStopped = false;
|
|
78
|
-
if (previousGroup.pid && previousGroup.pid !== group.pid) {
|
|
79
|
-
try {
|
|
80
|
-
process.kill(previousGroup.pid, 0);
|
|
81
|
-
}
|
|
82
|
-
catch (error) {
|
|
83
|
-
previousStopped = error.code === 'ESRCH';
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
// The supervisor advances the trusted config epoch only after stopping the old
|
|
87
|
-
// native group. Reconfirm its recorded PID before publishing that replacement.
|
|
88
|
-
if (previousIdentityMatches && previousEpoch !== undefined && config.runtimeEpoch > previousEpoch && previousStopped) {
|
|
89
|
-
await journal.writeExecutionEpoch({
|
|
90
|
-
runtimeEpoch: state.runtimeEpoch, ...group, previousPid: previousGroup.pid, stopConfirmed: true,
|
|
91
|
-
});
|
|
92
|
-
await journal.replaceSessions(journal.listSessions().map((session) => ({ ...session, recoverability: 'history_only' })));
|
|
93
|
-
}
|
|
94
|
-
else {
|
|
95
|
-
await journal.noteExecutionGroup(group);
|
|
96
|
-
}
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
catch (error) {
|
|
100
|
-
const code = error instanceof Error ? error.message : '';
|
|
101
|
-
state.nativeError = code === 'codex_model_catalog_unavailable' ? code : 'codex_start_failed';
|
|
102
|
-
console.error(`[workspace-runtime] ${state.nativeError}`);
|
|
103
|
-
}
|
|
104
|
-
const server = createServer((request, response) => {
|
|
105
|
-
void handleRuntimeRequest(state, request, response);
|
|
106
|
-
});
|
|
107
|
-
server.on('upgrade', (request, socket, head) => {
|
|
108
|
-
const pathname = new URL(request.url ?? '/', 'http://127.0.0.1').pathname;
|
|
109
|
-
if (/^\/runtime\/terminals\/[^/]+\/connect$/.test(pathname)) {
|
|
110
|
-
void terminalHost(state).handleUpgrade(request, socket, head);
|
|
111
|
-
return;
|
|
112
|
-
}
|
|
113
|
-
if (pathname === '/runtime/desktop/connect') {
|
|
114
|
-
desktopHost(state).handleUpgrade(request, socket, head);
|
|
115
|
-
return;
|
|
116
|
-
}
|
|
117
|
-
socket.destroy();
|
|
118
|
-
});
|
|
119
|
-
const port = await listenOn(server, config.listen.host, config.listen.port);
|
|
120
|
-
return {
|
|
121
|
-
config: state.config,
|
|
122
|
-
state,
|
|
123
|
-
url: `http://${formatHost(config.listen.host)}:${port}`,
|
|
124
|
-
async close() {
|
|
125
|
-
const serverClosed = closeServer(server);
|
|
126
|
-
await closeCliCredentials(state);
|
|
127
|
-
await gitCredentials?.close();
|
|
128
|
-
try {
|
|
129
|
-
await disposeDesktopHost(state);
|
|
130
|
-
}
|
|
131
|
-
finally {
|
|
132
|
-
disposeTerminalHost(state);
|
|
133
|
-
try {
|
|
134
|
-
await native?.close?.();
|
|
135
|
-
}
|
|
136
|
-
catch {
|
|
137
|
-
/* adapter shutdown is best-effort */
|
|
138
|
-
}
|
|
139
|
-
await serverClosed;
|
|
140
|
-
await stopArtifactObserver();
|
|
141
|
-
await journal?.close();
|
|
142
|
-
lock.release();
|
|
143
|
-
}
|
|
144
|
-
},
|
|
145
|
-
};
|
|
146
|
-
}
|
|
147
|
-
catch (error) {
|
|
148
|
-
await gitCredentials?.close().catch(() => undefined);
|
|
149
|
-
await journal?.close().catch(() => undefined);
|
|
150
|
-
lock.release();
|
|
151
|
-
throw error;
|
|
152
|
-
}
|
|
153
|
-
}
|
|
154
|
-
function listenOn(server, host, port) {
|
|
155
|
-
return new Promise((resolve, reject) => {
|
|
156
|
-
const onError = (error) => reject(error);
|
|
157
|
-
server.once('error', onError);
|
|
158
|
-
server.listen(port, host, () => {
|
|
159
|
-
server.removeListener('error', onError);
|
|
160
|
-
const address = server.address();
|
|
161
|
-
if (!address || typeof address === 'string') {
|
|
162
|
-
reject(new Error('listen_failed'));
|
|
163
|
-
return;
|
|
164
|
-
}
|
|
165
|
-
resolve(address.port);
|
|
166
|
-
});
|
|
167
|
-
});
|
|
168
|
-
}
|
|
169
|
-
function closeServer(server) {
|
|
170
|
-
return new Promise((resolve, reject) => {
|
|
171
|
-
server.close((error) => {
|
|
172
|
-
if (error)
|
|
173
|
-
reject(error);
|
|
174
|
-
else
|
|
175
|
-
resolve();
|
|
176
|
-
});
|
|
177
|
-
});
|
|
178
|
-
}
|
|
179
|
-
function formatHost(host) {
|
|
180
|
-
return host.includes(':') ? `[${host}]` : host;
|
|
181
|
-
}
|
|
182
|
-
function defaultNativeAdapter(state) {
|
|
183
|
-
const config = state.config;
|
|
184
|
-
if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'loopback')
|
|
185
|
-
return createLoopbackNativeAdapter();
|
|
186
|
-
const hasLauncher = Boolean(process.env.PLAYCRAFT_LAUNCHER_SOCKET);
|
|
187
|
-
const multi = config.workspaceMode === 'multi';
|
|
188
|
-
if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'codex' && !multi && !hasLauncher) {
|
|
189
|
-
throw new Error('codex_requires_managed_launcher');
|
|
190
|
-
}
|
|
191
|
-
if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'codex' || (multi && hasLauncher)) {
|
|
192
|
-
return createCodexAppServerAdapter({
|
|
193
|
-
config,
|
|
194
|
-
...(multi ? { modelBroker: new WorkspaceModelBroker(state) } : {}),
|
|
195
|
-
...(multi ? { loadMcpConfig: async (cwd) => {
|
|
196
|
-
const { workspaceId } = await workspaceContextFromRoot(state, cwd);
|
|
197
|
-
return loadWorkspaceMcpConfig(state, workspaceId);
|
|
198
|
-
} } : {}),
|
|
199
|
-
loadSkillArtifact: async (cwd, entry) => {
|
|
200
|
-
const { workspaceId, directoryName } = await workspaceContextFromRoot(state, cwd);
|
|
201
|
-
return loadWorkspaceSkillArtifact(state, workspaceId, entry, directoryName === 'root' ? 'basic' : directoryName);
|
|
202
|
-
},
|
|
203
|
-
onSkillProcessRestart: process => state.journal.noteExecutionGroup(process),
|
|
204
|
-
});
|
|
205
|
-
}
|
|
206
|
-
return undefined;
|
|
207
|
-
}
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
import { timingSafeEqual } from 'node:crypto';
|
|
2
|
-
export function extractControlToken(headers) {
|
|
3
|
-
const authorization = headerValue(headers.authorization);
|
|
4
|
-
if (authorization?.startsWith('Bearer ')) {
|
|
5
|
-
return authorization.slice('Bearer '.length).trim() || null;
|
|
6
|
-
}
|
|
7
|
-
const dedicated = headerValue(headers['x-playcraft-control-token']);
|
|
8
|
-
return dedicated?.trim() || null;
|
|
9
|
-
}
|
|
10
|
-
export function controlTokenMatches(expected, actual) {
|
|
11
|
-
if (!actual)
|
|
12
|
-
return false;
|
|
13
|
-
const left = Buffer.from(expected);
|
|
14
|
-
const right = Buffer.from(actual);
|
|
15
|
-
if (left.length !== right.length)
|
|
16
|
-
return false;
|
|
17
|
-
return timingSafeEqual(left, right);
|
|
18
|
-
}
|
|
19
|
-
function headerValue(value) {
|
|
20
|
-
return Array.isArray(value) ? value[0] : value;
|
|
21
|
-
}
|