@playcraft/cli 0.1.50-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 -283
- package/dist/workspace-runtime/previews/runtime-preview.js +0 -177
- 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 -441
- package/dist/workspace-runtime/server/accept-operation.js +0 -61
- package/dist/workspace-runtime/server/asset-transfers.js +0 -63
- 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 -1632
- 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 -1340
- 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/asset-transfer-dependencies.js +0 -81
- package/dist/workspace-runtime/workspaces/asset-transfer-publish.js +0 -434
- package/dist/workspace-runtime/workspaces/asset-transfer-storage.js +0 -389
- 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-mutations.js +0 -238
- package/dist/workspace-runtime/workspaces/directory-revisions.js +0 -56
- 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 -313
- 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/parameter-agent-inputs.js +0 -87
- package/dist/workspace-runtime/workspaces/parameter-agent-protocol.js +0 -29
- package/dist/workspace-runtime/workspaces/parameter-agent-store.js +0 -58
- package/dist/workspace-runtime/workspaces/parameter-agent.js +0 -282
- package/dist/workspace-runtime/workspaces/parameters.js +0 -295
- 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,56 +0,0 @@
|
|
|
1
|
-
import { createHash } from 'node:crypto';
|
|
2
|
-
import { lstat } from 'node:fs/promises';
|
|
3
|
-
import { join } from 'node:path';
|
|
4
|
-
import { isMutableWorkspaceDirectoryPath } from '@playcraft/common/cloud-workspace/runtime';
|
|
5
|
-
import { listWorkspaceFiles } from './files.js';
|
|
6
|
-
/** Reuse the listing's streamed hashes; only directory and preservation-marker metadata is sampled again. */
|
|
7
|
-
export async function observeWorkspaceDirectories(root, journal, scope, listed) {
|
|
8
|
-
const previous = journal.fileRevisions(scope);
|
|
9
|
-
const result = listed ?? await listWorkspaceFiles(root, previous);
|
|
10
|
-
const directoryRevisions = {};
|
|
11
|
-
const fingerprints = new Map();
|
|
12
|
-
for (const path of result.directories ?? []) {
|
|
13
|
-
if (!isMutableWorkspaceDirectoryPath(path)
|
|
14
|
-
|| result.unreadablePaths?.some(item => item === path || item.startsWith(`${path}/`)))
|
|
15
|
-
continue;
|
|
16
|
-
const stat = await lstat(join(root, ...path.split('/')));
|
|
17
|
-
if (!stat.isDirectory() || stat.isSymbolicLink())
|
|
18
|
-
continue;
|
|
19
|
-
const marker = await lstat(join(root, ...path.split('/'), '.gitkeep')).catch(error => {
|
|
20
|
-
if (error.code !== 'ENOENT')
|
|
21
|
-
throw error;
|
|
22
|
-
return undefined;
|
|
23
|
-
});
|
|
24
|
-
fingerprints.set(path, JSON.stringify([path, stat.dev, stat.ino, stat.mtimeMs, stat.ctimeMs,
|
|
25
|
-
marker && [marker.dev, marker.ino, marker.size, marker.mtimeMs, marker.ctimeMs]]));
|
|
26
|
-
}
|
|
27
|
-
for (const [path] of fingerprints) {
|
|
28
|
-
const hash = createHash('sha256').update('directory\0');
|
|
29
|
-
for (const [child, metadata] of fingerprints)
|
|
30
|
-
if (child === path || child.startsWith(`${path}/`))
|
|
31
|
-
hash.update(metadata);
|
|
32
|
-
for (const file of result.files)
|
|
33
|
-
if (file.path.startsWith(`${path}/`))
|
|
34
|
-
hash.update(JSON.stringify([file.path, file.contentHash, file.size]));
|
|
35
|
-
const contentHash = hash.digest('hex');
|
|
36
|
-
const old = previous[path];
|
|
37
|
-
const revision = old ? old.revision + Number(old.contentHash !== contentHash) : 0;
|
|
38
|
-
if (!old || old.contentHash !== contentHash)
|
|
39
|
-
await journal.putFileRevision(path, { revision, contentHash }, scope);
|
|
40
|
-
directoryRevisions[path] = revision;
|
|
41
|
-
}
|
|
42
|
-
for (const file of result.files) {
|
|
43
|
-
const old = previous[file.path];
|
|
44
|
-
const revision = old ? old.revision + Number(old.contentHash !== file.contentHash) : 0;
|
|
45
|
-
if (!old || old.contentHash !== file.contentHash)
|
|
46
|
-
await journal.putFileRevision(file.path, { revision, contentHash: file.contentHash }, scope);
|
|
47
|
-
file.revision = revision;
|
|
48
|
-
}
|
|
49
|
-
// Retain tombstones so recreating the same path cannot satisfy an old revision.
|
|
50
|
-
const present = new Set([...result.files.map(file => file.path), ...(result.directories ?? [])]);
|
|
51
|
-
for (const [path, old] of Object.entries(previous)) {
|
|
52
|
-
if (old.contentHash && !present.has(path) && !result.unreadablePaths?.some(item => path === item || path.startsWith(`${item}/`)))
|
|
53
|
-
await journal.putFileRevision(path, { revision: old.revision + 1, contentHash: '' }, scope);
|
|
54
|
-
}
|
|
55
|
-
return { ...result, directoryRevisions };
|
|
56
|
-
}
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
import { execFile } from 'node:child_process';
|
|
2
|
-
import { promisify } from 'node:util';
|
|
3
|
-
import { workspaceRoot, WorkspaceContextError } from './registry.js';
|
|
4
|
-
const execute = promisify(execFile);
|
|
5
|
-
/** Measures registered checkouts only when requested; journal activity never scans private neighboring workspaces. */
|
|
6
|
-
export async function readWorkspaceDirectoryStats(state, workspaceId) {
|
|
7
|
-
const binding = state.journal.getWorkspace(workspaceId);
|
|
8
|
-
if (!binding)
|
|
9
|
-
throw new WorkspaceContextError('workspace_not_registered');
|
|
10
|
-
const names = [...new Set(['basic', ...(binding.directories ?? []).map(directory => directory.directoryName)])];
|
|
11
|
-
const operations = state.journal.listOperations().map(item => item.operation).filter(operation => operation.workspaceId === workspaceId);
|
|
12
|
-
const events = state.journal.listEvents().flatMap(event => {
|
|
13
|
-
const payload = event.payload && typeof event.payload === 'object' ? event.payload : {};
|
|
14
|
-
const session = typeof payload.sessionId === 'string' ? state.journal.getSession(payload.sessionId) : undefined;
|
|
15
|
-
if ((payload.workspaceId ?? session?.workspaceId) !== workspaceId)
|
|
16
|
-
return [];
|
|
17
|
-
return [{ directoryName: String(payload.directoryName ?? session?.directoryName ?? 'basic'), occurredAt: event.occurredAt }];
|
|
18
|
-
});
|
|
19
|
-
const latest = (dates) => {
|
|
20
|
-
const timestamps = dates.map(value => Date.parse(value)).filter(Number.isFinite);
|
|
21
|
-
return timestamps.length ? new Date(Math.max(...timestamps)).toISOString() : null;
|
|
22
|
-
};
|
|
23
|
-
const directories = [];
|
|
24
|
-
for (const directoryName of names) {
|
|
25
|
-
const lastUsedAt = latest([...operations.filter(operation => (operation.directoryName ?? 'basic') === directoryName).map(operation => operation.updatedAt),
|
|
26
|
-
...events.filter(event => event.directoryName === directoryName).map(event => event.occurredAt)]);
|
|
27
|
-
if (binding.directories?.some(directory => directory.directoryName === directoryName && directory.status === 'reclaimed')) {
|
|
28
|
-
directories.push({ directoryName, sizeBytes: 0, lastUsedAt, status: 'reclaimed' });
|
|
29
|
-
continue;
|
|
30
|
-
}
|
|
31
|
-
let root;
|
|
32
|
-
try {
|
|
33
|
-
root = await workspaceRoot(state, workspaceId, directoryName);
|
|
34
|
-
}
|
|
35
|
-
catch (error) {
|
|
36
|
-
if (!(error instanceof WorkspaceContextError) || error.message !== 'workspace_not_prepared')
|
|
37
|
-
throw error;
|
|
38
|
-
directories.push({ directoryName, sizeBytes: 0, lastUsedAt, status: 'missing' });
|
|
39
|
-
continue;
|
|
40
|
-
}
|
|
41
|
-
const output = await execute('du', ['-sk', root], { timeout: 30_000, maxBuffer: 4096 });
|
|
42
|
-
const blocks = Number(output.stdout.trim().split(/\s+/)[0]);
|
|
43
|
-
if (!Number.isSafeInteger(blocks) || blocks < 0 || !Number.isSafeInteger(blocks * 1024))
|
|
44
|
-
throw new Error('workspace_directory_stats_invalid');
|
|
45
|
-
directories.push({ directoryName, sizeBytes: blocks * 1024, lastUsedAt, status: 'present' });
|
|
46
|
-
}
|
|
47
|
-
return { workspaceId, sizeBytes: directories.reduce((sum, directory) => sum + directory.sizeBytes, 0),
|
|
48
|
-
lastUsedAt: latest([...operations.map(operation => operation.updatedAt), ...events.map(event => event.occurredAt)]), directories };
|
|
49
|
-
}
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
import { createHash } from 'node:crypto';
|
|
2
|
-
import { constants } from 'node:fs';
|
|
3
|
-
import { open } from 'node:fs/promises';
|
|
4
|
-
import { ASSET_TRANSFER_FILE_MAX_BYTES } from '@playcraft/common/cloud-workspace/runtime';
|
|
5
|
-
export async function sampleDiskFile(path) {
|
|
6
|
-
const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
|
|
7
|
-
try {
|
|
8
|
-
const before = await handle.stat();
|
|
9
|
-
if (!before.isFile() || before.size > ASSET_TRANSFER_FILE_MAX_BYTES)
|
|
10
|
-
throw new Error('snapshot_body_missing');
|
|
11
|
-
const digest = createHash('sha256');
|
|
12
|
-
const chunk = Buffer.allocUnsafe(64 * 1024);
|
|
13
|
-
let position = 0;
|
|
14
|
-
for (;;) {
|
|
15
|
-
const { bytesRead } = await handle.read(chunk, 0, chunk.length, position);
|
|
16
|
-
if (!bytesRead)
|
|
17
|
-
break;
|
|
18
|
-
digest.update(chunk.subarray(0, bytesRead));
|
|
19
|
-
position += bytesRead;
|
|
20
|
-
if (position > ASSET_TRANSFER_FILE_MAX_BYTES)
|
|
21
|
-
throw new Error('snapshot_body_missing');
|
|
22
|
-
}
|
|
23
|
-
const after = await handle.stat();
|
|
24
|
-
if (before.size !== after.size || before.mtimeMs !== after.mtimeMs || before.ctimeMs !== after.ctimeMs || position !== before.size)
|
|
25
|
-
throw new Error('snapshot_body_missing');
|
|
26
|
-
return { hash: digest.digest('hex'), size: position, mode: before.mode & 0o777, modifiedAt: before.mtime.toISOString() };
|
|
27
|
-
}
|
|
28
|
-
finally {
|
|
29
|
-
await handle.close();
|
|
30
|
-
}
|
|
31
|
-
}
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
import { cp, mkdir } from 'node:fs/promises';
|
|
2
|
-
import { join } from 'node:path';
|
|
3
|
-
import { resolveCliPackageRoot } from '../../scaffold/compose.js';
|
|
4
|
-
import { importBuiltinProjectSkills } from '../../project-skills/builtin-import.js';
|
|
5
|
-
import { createHash } from 'node:crypto';
|
|
6
|
-
import { canonicalProjectSkillsJson } from '@playcraft/common/project-skills';
|
|
7
|
-
import { syncLocalProjectSkills } from '../../project-skills/local-store.js';
|
|
8
|
-
import { selectOptionalPlatformSkills } from './optional-platform-skills.js';
|
|
9
|
-
export const EMPTY_WORKSPACE_REPOSITORY_SKILLS = [
|
|
10
|
-
'playcraft-skill-recommender',
|
|
11
|
-
'playcraft-image-generation',
|
|
12
|
-
'playcraft-audio-generation',
|
|
13
|
-
'playcraft-image-processing',
|
|
14
|
-
'playcraft-build-optimizer',
|
|
15
|
-
];
|
|
16
|
-
export const EMPTY_WORKSPACE_PLATFORM_SKILLS = ['playcraft-video-understanding', 'playcraft-replica-validation'];
|
|
17
|
-
export const EMPTY_WORKSPACE_DEFAULT_SKILLS = [...EMPTY_WORKSPACE_REPOSITORY_SKILLS, ...EMPTY_WORKSPACE_PLATFORM_SKILLS];
|
|
18
|
-
/** Only called in a new, unpublished staging directory; existing workspaces are never scaffolded. */
|
|
19
|
-
export async function scaffoldEmptyWorkspace(root, skillCache, access) {
|
|
20
|
-
const selected = await selectOptionalPlatformSkills([...EMPTY_WORKSPACE_PLATFORM_SKILLS], access);
|
|
21
|
-
const cliRoot = resolveCliPackageRoot();
|
|
22
|
-
const template = join(cliRoot, 'project-templates', 'empty');
|
|
23
|
-
for (const [source, target] of [
|
|
24
|
-
['gitignore', '.gitignore'],
|
|
25
|
-
['AGENTS.md', 'AGENTS.md'],
|
|
26
|
-
]) {
|
|
27
|
-
await cp(join(template, source), join(root, target), { force: false, errorOnExist: true });
|
|
28
|
-
}
|
|
29
|
-
const skills = join(root, '.agents', 'skills');
|
|
30
|
-
await mkdir(skills, { recursive: true });
|
|
31
|
-
for (const name of EMPTY_WORKSPACE_REPOSITORY_SKILLS) {
|
|
32
|
-
await cp(join(cliRoot, 'project-template', '.claude', 'skills', name), join(skills, name), {
|
|
33
|
-
recursive: true,
|
|
34
|
-
force: false,
|
|
35
|
-
errorOnExist: true,
|
|
36
|
-
});
|
|
37
|
-
}
|
|
38
|
-
const snapshot = await syncLocalProjectSkills(root, skillCache);
|
|
39
|
-
if (selected)
|
|
40
|
-
await importBuiltinProjectSkills(root, { names: [...EMPTY_WORKSPACE_PLATFORM_SKILLS], expectedDeclarationHash: snapshot.lock.declarationHash,
|
|
41
|
-
expectedLockHash: createHash('sha256').update(canonicalProjectSkillsJson(snapshot.lock)).digest('hex') }, skillCache, access, selected, true);
|
|
42
|
-
}
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
import { constants } from 'node:fs';
|
|
2
|
-
import { lstat, open } from 'node:fs/promises';
|
|
3
|
-
import { basename, extname } from 'node:path';
|
|
4
|
-
import { workspaceRelativePathSchema } from '@playcraft/common/cloud-workspace/runtime';
|
|
5
|
-
import { artifactMime, artifactPath } from './artifact-files.js';
|
|
6
|
-
import { serveOpenedWorkspaceContent } from './binary-content.js';
|
|
7
|
-
import { InvalidWorkspacePathError, resolveWorkspaceFile } from './files.js';
|
|
8
|
-
const additionalMediaTypes = {
|
|
9
|
-
'.aac': 'audio/aac', '.opus': 'audio/ogg', '.oga': 'audio/ogg', '.aif': 'audio/aiff', '.aiff': 'audio/aiff',
|
|
10
|
-
'.bmp': 'image/bmp', '.ico': 'image/vnd.microsoft.icon', '.heic': 'image/heic', '.heif': 'image/heif',
|
|
11
|
-
'.tif': 'image/tiff', '.tiff': 'image/tiff',
|
|
12
|
-
};
|
|
13
|
-
export async function serveWorkspaceFileContent(root, path, request, response) {
|
|
14
|
-
let handle;
|
|
15
|
-
let size;
|
|
16
|
-
try {
|
|
17
|
-
if (!workspaceRelativePathSchema.safeParse(path).success)
|
|
18
|
-
throw new InvalidWorkspacePathError(path);
|
|
19
|
-
// Check every component before resolving, so missing files cannot create parent directories.
|
|
20
|
-
await artifactPath(root, path);
|
|
21
|
-
const target = await resolveWorkspaceFile(root, path);
|
|
22
|
-
handle = await open(target, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
23
|
-
const stat = await handle.stat();
|
|
24
|
-
if (!stat.isFile() || stat.nlink !== 1)
|
|
25
|
-
throw new Error('file_not_found');
|
|
26
|
-
// Bind the open handle to the authorized file even if a parent changed during open.
|
|
27
|
-
const verified = await artifactPath(root, path);
|
|
28
|
-
const current = await lstat(verified);
|
|
29
|
-
if (!current.isFile() || current.nlink !== 1 || current.dev !== stat.dev || current.ino !== stat.ino)
|
|
30
|
-
throw new InvalidWorkspacePathError(path);
|
|
31
|
-
size = stat.size;
|
|
32
|
-
}
|
|
33
|
-
catch (error) {
|
|
34
|
-
await handle?.close();
|
|
35
|
-
const code = error?.code;
|
|
36
|
-
const invalid = error instanceof InvalidWorkspacePathError || (error instanceof Error && error.message === 'invalid_artifact_path');
|
|
37
|
-
const denied = code === 'EACCES' || code === 'EPERM';
|
|
38
|
-
response.writeHead(invalid ? 400 : denied ? 403 : 404, { 'content-type': 'application/json', 'cache-control': 'no-store' });
|
|
39
|
-
response.end(JSON.stringify({ error: invalid ? 'invalid_workspace_path' : denied ? 'workspace_permission_denied' : 'file_not_found' }));
|
|
40
|
-
return;
|
|
41
|
-
}
|
|
42
|
-
await serveOpenedWorkspaceContent({
|
|
43
|
-
handle,
|
|
44
|
-
name: basename(path),
|
|
45
|
-
mimeType: additionalMediaTypes[extname(path).toLowerCase()] ?? artifactMime(path),
|
|
46
|
-
size,
|
|
47
|
-
}, request, response);
|
|
48
|
-
}
|
|
@@ -1,116 +0,0 @@
|
|
|
1
|
-
import { createHash } from 'node:crypto';
|
|
2
|
-
import { lstat, opendir, realpath } from 'node:fs/promises';
|
|
3
|
-
import { join, relative, sep } from 'node:path';
|
|
4
|
-
import { workspaceFileSearchQuerySchema, workspaceRelativePathSchema, } from '@playcraft/common/cloud-workspace/runtime';
|
|
5
|
-
const SKIP_DIRECTORIES = new Set(['.git', 'node_modules', '.playcraft', '.next', 'dist', 'build', 'coverage', '.turbo']);
|
|
6
|
-
const SCAN_PAGE_ENTRIES = 1000;
|
|
7
|
-
export class InvalidWorkspaceSearchError extends Error {
|
|
8
|
-
code;
|
|
9
|
-
constructor(code = 'invalid_workspace_search') {
|
|
10
|
-
super(code);
|
|
11
|
-
this.code = code;
|
|
12
|
-
this.name = 'InvalidWorkspaceSearchError';
|
|
13
|
-
}
|
|
14
|
-
}
|
|
15
|
-
/** Enumerates names only. The cursor is scoped to the resolved checkout and query, never to a caller supplied path. */
|
|
16
|
-
export async function searchWorkspaceFiles(root, query, options = {}) {
|
|
17
|
-
const parsed = workspaceFileSearchQuerySchema.safeParse(query);
|
|
18
|
-
if (!parsed.success)
|
|
19
|
-
throw new InvalidWorkspaceSearchError();
|
|
20
|
-
options.signal?.throwIfAborted();
|
|
21
|
-
const rootReal = await realpath(root);
|
|
22
|
-
const needle = parsed.data.query.toLocaleLowerCase();
|
|
23
|
-
const scope = createHash('sha256').update(rootReal).update('\0').update(needle).digest('hex');
|
|
24
|
-
const start = decodeCursor(parsed.data.cursor, scope);
|
|
25
|
-
const files = [];
|
|
26
|
-
let offset = 0;
|
|
27
|
-
for await (const path of walk(rootReal, rootReal, options.signal)) {
|
|
28
|
-
options.signal?.throwIfAborted();
|
|
29
|
-
offset += 1;
|
|
30
|
-
if (offset <= start)
|
|
31
|
-
continue;
|
|
32
|
-
if (path && path.toLocaleLowerCase().includes(needle)) {
|
|
33
|
-
const target = join(rootReal, ...path.split('/'));
|
|
34
|
-
const info = await lstat(target).catch(ignoreUnavailable);
|
|
35
|
-
const targetReal = info?.isFile() && !info.isSymbolicLink() ? await realpath(target).catch(ignoreUnavailable) : undefined;
|
|
36
|
-
if (targetReal && inside(rootReal, targetReal))
|
|
37
|
-
files.push({ path });
|
|
38
|
-
}
|
|
39
|
-
if (files.length >= parsed.data.limit || offset - start >= SCAN_PAGE_ENTRIES) {
|
|
40
|
-
return { files, truncated: true, nextCursor: encodeCursor(scope, offset) };
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
return { files, truncated: false };
|
|
44
|
-
}
|
|
45
|
-
async function* walk(root, current, signal) {
|
|
46
|
-
signal?.throwIfAborted();
|
|
47
|
-
const currentInfo = await lstat(current).catch(ignoreUnavailable);
|
|
48
|
-
if (!currentInfo?.isDirectory() || currentInfo.isSymbolicLink())
|
|
49
|
-
return;
|
|
50
|
-
const resolved = await realpath(current).catch(ignoreUnavailable);
|
|
51
|
-
if (!resolved || !inside(root, resolved))
|
|
52
|
-
return;
|
|
53
|
-
const directory = await opendir(resolved).catch(ignoreUnavailable);
|
|
54
|
-
if (!directory)
|
|
55
|
-
return;
|
|
56
|
-
// Recheck after opening: a concurrently replaced directory must not reveal another checkout's paths.
|
|
57
|
-
const openedPath = await realpath(current).catch(ignoreUnavailable);
|
|
58
|
-
if (openedPath !== resolved || !inside(root, openedPath)) {
|
|
59
|
-
await directory.close();
|
|
60
|
-
return;
|
|
61
|
-
}
|
|
62
|
-
for await (const entry of directory) {
|
|
63
|
-
signal?.throwIfAborted();
|
|
64
|
-
if (['.git', 'node_modules', '.playcraft'].includes(entry.name)) {
|
|
65
|
-
yield undefined;
|
|
66
|
-
continue;
|
|
67
|
-
}
|
|
68
|
-
const child = join(resolved, entry.name);
|
|
69
|
-
const path = relative(root, child).split(sep).join('/');
|
|
70
|
-
if (!workspaceRelativePathSchema.safeParse(path).success) {
|
|
71
|
-
yield undefined;
|
|
72
|
-
continue;
|
|
73
|
-
}
|
|
74
|
-
if (entry.isDirectory()) {
|
|
75
|
-
yield undefined;
|
|
76
|
-
if (!SKIP_DIRECTORIES.has(entry.name))
|
|
77
|
-
yield* walk(root, child, signal);
|
|
78
|
-
continue;
|
|
79
|
-
}
|
|
80
|
-
if (!entry.isFile()) {
|
|
81
|
-
yield undefined;
|
|
82
|
-
continue;
|
|
83
|
-
}
|
|
84
|
-
yield path;
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
function inside(root, path) {
|
|
88
|
-
const value = relative(root, path);
|
|
89
|
-
return value === '' || (value !== '..' && !value.startsWith(`..${sep}`) && !value.startsWith(sep));
|
|
90
|
-
}
|
|
91
|
-
function ignoreUnavailable(error) {
|
|
92
|
-
if (['ENOENT', 'ENOTDIR', 'EACCES'].includes(error.code ?? ''))
|
|
93
|
-
return undefined;
|
|
94
|
-
throw error;
|
|
95
|
-
}
|
|
96
|
-
function encodeCursor(scope, offset) {
|
|
97
|
-
return Buffer.from(JSON.stringify({ v: 1, scope, offset })).toString('base64url');
|
|
98
|
-
}
|
|
99
|
-
function decodeCursor(cursor, scope) {
|
|
100
|
-
if (!cursor)
|
|
101
|
-
return 0;
|
|
102
|
-
try {
|
|
103
|
-
if (!/^[A-Za-z0-9_-]+$/.test(cursor))
|
|
104
|
-
throw new Error();
|
|
105
|
-
const value = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
|
|
106
|
-
if (typeof value !== 'object' || value === null)
|
|
107
|
-
throw new Error();
|
|
108
|
-
const { v, scope: suppliedScope, offset } = value;
|
|
109
|
-
if (v !== 1 || suppliedScope !== scope || typeof offset !== 'number' || !Number.isSafeInteger(offset) || offset < 0)
|
|
110
|
-
throw new Error();
|
|
111
|
-
return offset;
|
|
112
|
-
}
|
|
113
|
-
catch {
|
|
114
|
-
throw new InvalidWorkspaceSearchError('invalid_workspace_search_cursor');
|
|
115
|
-
}
|
|
116
|
-
}
|
|
@@ -1,150 +0,0 @@
|
|
|
1
|
-
import { lstat, mkdir, readdir, readFile, realpath, writeFile } from 'node:fs/promises';
|
|
2
|
-
import { createHash } from 'node:crypto';
|
|
3
|
-
import { dirname, join, relative, resolve, sep } from 'node:path';
|
|
4
|
-
import { hashWorkspaceFileContent, workspaceFileContentSchema, workspaceFileListSchema, workspaceRelativePathSchema, } from '@playcraft/common/cloud-workspace/runtime';
|
|
5
|
-
import { sampleDiskFile } from './disk-snapshot.js';
|
|
6
|
-
const SKIP_DIRECTORY_NAMES = new Set(['.git', 'node_modules', '.playcraft-temp']);
|
|
7
|
-
const LARGE_FILE_STREAM_THRESHOLD = 8 * 1024 * 1024;
|
|
8
|
-
export class InvalidWorkspacePathError extends Error {
|
|
9
|
-
code = 'invalid_workspace_path';
|
|
10
|
-
constructor(path) {
|
|
11
|
-
super(path);
|
|
12
|
-
this.name = 'InvalidWorkspacePathError';
|
|
13
|
-
}
|
|
14
|
-
}
|
|
15
|
-
export async function ensureWorkspaceRoot(root) {
|
|
16
|
-
await mkdir(root, { recursive: true, mode: 0o700 });
|
|
17
|
-
return realpath(root);
|
|
18
|
-
}
|
|
19
|
-
export async function resolveWorkspaceFile(root, relativePath) {
|
|
20
|
-
const parsed = workspaceRelativePathSchema.safeParse(relativePath);
|
|
21
|
-
if (!parsed.success)
|
|
22
|
-
throw new InvalidWorkspacePathError(relativePath);
|
|
23
|
-
const rootReal = await ensureWorkspaceRoot(root);
|
|
24
|
-
const target = resolve(rootReal, ...parsed.data.split('/'));
|
|
25
|
-
assertInsideRoot(rootReal, target);
|
|
26
|
-
try {
|
|
27
|
-
const existing = await realpath(target);
|
|
28
|
-
assertInsideRoot(rootReal, existing);
|
|
29
|
-
return existing;
|
|
30
|
-
}
|
|
31
|
-
catch (error) {
|
|
32
|
-
if (error.code !== 'ENOENT')
|
|
33
|
-
throw error;
|
|
34
|
-
await assertParentInsideRoot(rootReal, dirname(target));
|
|
35
|
-
return target;
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
export async function writeWorkspaceFile(root, relativePath, content) {
|
|
39
|
-
const target = await resolveWorkspaceFile(root, relativePath);
|
|
40
|
-
await mkdir(dirname(target), { recursive: true, mode: 0o700 });
|
|
41
|
-
const bytes = Buffer.from(content, 'utf8');
|
|
42
|
-
await writeFile(target, bytes, { mode: 0o600 });
|
|
43
|
-
return { path: relativePath, contentHash: hashWorkspaceFileContent(content), size: bytes.byteLength };
|
|
44
|
-
}
|
|
45
|
-
export async function readWorkspaceFile(root, relativePath, revisions) {
|
|
46
|
-
const target = await resolveWorkspaceFile(root, relativePath);
|
|
47
|
-
const content = await readFile(target, 'utf8');
|
|
48
|
-
const contentHash = hashWorkspaceFileContent(content);
|
|
49
|
-
return workspaceFileContentSchema.parse({
|
|
50
|
-
path: relativePath,
|
|
51
|
-
revision: revisions[relativePath]?.revision ?? 0,
|
|
52
|
-
contentHash,
|
|
53
|
-
content,
|
|
54
|
-
});
|
|
55
|
-
}
|
|
56
|
-
export async function listWorkspaceFiles(root, revisions) {
|
|
57
|
-
const rootReal = await ensureWorkspaceRoot(root);
|
|
58
|
-
const files = [];
|
|
59
|
-
const directories = new Set();
|
|
60
|
-
const unreadablePaths = new Set();
|
|
61
|
-
for (const relativePath of await walkWorkspaceFiles(rootReal, rootReal, unreadablePaths, directories)) {
|
|
62
|
-
const target = join(rootReal, ...relativePath.split('/'));
|
|
63
|
-
try {
|
|
64
|
-
const stat = await lstat(target);
|
|
65
|
-
if (stat.size > LARGE_FILE_STREAM_THRESHOLD) {
|
|
66
|
-
const sampled = await sampleDiskFile(target);
|
|
67
|
-
files.push({ path: relativePath, revision: revisions[relativePath]?.revision ?? 0, contentHash: sampled.hash, size: sampled.size, modifiedAt: sampled.modifiedAt });
|
|
68
|
-
continue;
|
|
69
|
-
}
|
|
70
|
-
const content = await readFile(target);
|
|
71
|
-
const after = await lstat(target);
|
|
72
|
-
if (stat.ino !== after.ino || stat.size !== after.size || stat.mtimeMs !== after.mtimeMs || stat.ctimeMs !== after.ctimeMs || content.length !== after.size) {
|
|
73
|
-
const sampled = await sampleDiskFile(target);
|
|
74
|
-
files.push({ path: relativePath, revision: revisions[relativePath]?.revision ?? 0, contentHash: sampled.hash, size: sampled.size, modifiedAt: sampled.modifiedAt });
|
|
75
|
-
continue;
|
|
76
|
-
}
|
|
77
|
-
files.push({
|
|
78
|
-
path: relativePath,
|
|
79
|
-
revision: revisions[relativePath]?.revision ?? 0,
|
|
80
|
-
contentHash: createHash('sha256').update(content).digest('hex'),
|
|
81
|
-
size: content.byteLength,
|
|
82
|
-
modifiedAt: after.mtime.toISOString(),
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
catch (error) {
|
|
86
|
-
if (!isPermissionDenied(error))
|
|
87
|
-
throw error;
|
|
88
|
-
unreadablePaths.add(relativePath);
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
files.sort((left, right) => left.path.localeCompare(right.path));
|
|
92
|
-
return workspaceFileListSchema.parse({ files, directories: [...directories].sort(), ...(unreadablePaths.size ? { unreadablePaths: [...unreadablePaths].sort() } : {}) });
|
|
93
|
-
}
|
|
94
|
-
async function walkWorkspaceFiles(rootReal, current, unreadablePaths, directories) {
|
|
95
|
-
const entries = await readdir(current, { withFileTypes: true });
|
|
96
|
-
const paths = [];
|
|
97
|
-
for (const entry of entries) {
|
|
98
|
-
const child = join(current, entry.name);
|
|
99
|
-
try {
|
|
100
|
-
if (entry.isDirectory()) {
|
|
101
|
-
if (SKIP_DIRECTORY_NAMES.has(entry.name) || entry.name === '.' || entry.name === '..')
|
|
102
|
-
continue;
|
|
103
|
-
const childReal = await realpath(child);
|
|
104
|
-
assertInsideRoot(rootReal, childReal);
|
|
105
|
-
const children = await walkWorkspaceFiles(rootReal, childReal, unreadablePaths, directories);
|
|
106
|
-
directories.add(toPosixRelative(rootReal, childReal));
|
|
107
|
-
paths.push(...children);
|
|
108
|
-
continue;
|
|
109
|
-
}
|
|
110
|
-
if (!entry.isFile() || entry.name === '.gitkeep')
|
|
111
|
-
continue;
|
|
112
|
-
const childReal = await realpath(child);
|
|
113
|
-
assertInsideRoot(rootReal, childReal);
|
|
114
|
-
paths.push(toPosixRelative(rootReal, childReal));
|
|
115
|
-
}
|
|
116
|
-
catch (error) {
|
|
117
|
-
if (!isPermissionDenied(error))
|
|
118
|
-
throw error;
|
|
119
|
-
unreadablePaths.add(toPosixRelative(rootReal, child));
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
return paths;
|
|
123
|
-
}
|
|
124
|
-
function isPermissionDenied(error) {
|
|
125
|
-
return ['EACCES', 'EPERM'].includes(String(error?.code));
|
|
126
|
-
}
|
|
127
|
-
async function assertParentInsideRoot(rootReal, parent) {
|
|
128
|
-
if (parent === rootReal)
|
|
129
|
-
return;
|
|
130
|
-
try {
|
|
131
|
-
const parentReal = await realpath(parent);
|
|
132
|
-
assertInsideRoot(rootReal, parentReal);
|
|
133
|
-
}
|
|
134
|
-
catch (error) {
|
|
135
|
-
if (error.code !== 'ENOENT')
|
|
136
|
-
throw error;
|
|
137
|
-
await mkdir(parent, { recursive: true, mode: 0o700 });
|
|
138
|
-
const parentReal = await realpath(parent);
|
|
139
|
-
assertInsideRoot(rootReal, parentReal);
|
|
140
|
-
}
|
|
141
|
-
}
|
|
142
|
-
function assertInsideRoot(rootReal, target) {
|
|
143
|
-
const rel = relative(rootReal, target);
|
|
144
|
-
if (rel === '' || rel.startsWith(`..${sep}`) || rel === '..' || rel.startsWith('..')) {
|
|
145
|
-
throw new InvalidWorkspacePathError(target);
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
function toPosixRelative(rootReal, target) {
|
|
149
|
-
return relative(rootReal, target).split(sep).join('/');
|
|
150
|
-
}
|