@playcraft/cli 0.1.52 → 0.1.53-beta
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 +62 -3
- package/SKILLS_REGISTRY.md +149 -0
- package/dist/agent/local-backend.js +1 -1
- package/dist/auth/account-activation.js +157 -0
- package/dist/auth/messages.js +30 -0
- package/dist/cli-root-help.js +2 -0
- package/dist/commands/build-all.js +5 -19
- package/dist/commands/build-temp.js +26 -0
- package/dist/commands/build.js +15 -28
- package/dist/commands/create.js +26 -33
- package/dist/commands/login.js +84 -42
- package/dist/commands/platform-skills.generated.js +19 -0
- package/dist/commands/playable.js +53 -0
- package/dist/commands/preview-runtime.js +21 -0
- package/dist/commands/skills.js +4 -0
- package/dist/commands/tools-3d.js +11 -0
- package/dist/commands/tools-batch.js +113 -0
- package/dist/commands/tools-generation.js +6 -0
- package/dist/commands/tools.js +2 -0
- package/dist/commands/video.js +122 -0
- package/dist/commands/workspace-runtime.js +54 -0
- package/dist/commands/workspace.js +40 -0
- package/dist/config.js +59 -4
- package/dist/index.js +42 -3
- package/dist/preview-runtime/distribution.js +77 -0
- package/dist/project-skills/builtin-import.js +225 -0
- package/dist/project-skills/commands.js +77 -0
- package/dist/project-skills/lifecycle.js +28 -0
- package/dist/project-skills/local-run.js +112 -0
- package/dist/project-skills/local-store.js +221 -0
- package/dist/project-skills/messages.js +80 -0
- package/dist/project-skills/reconcile.js +62 -0
- package/dist/project-skills/remote-cache.js +51 -0
- package/dist/project-skills/validation.js +19 -0
- package/dist/recording/messages.js +40 -0
- package/dist/recording/project-digest.js +85 -0
- package/dist/recording/recorder.js +293 -0
- package/dist/recording/scenario.js +50 -0
- package/dist/remix/clone.js +2 -0
- package/dist/remix/init-template.js +2 -0
- package/dist/remix/pull.js +2 -0
- package/dist/remix/push.js +21 -1
- package/dist/skill-registry/client.js +345 -0
- package/dist/skill-registry/commands.js +180 -0
- package/dist/skill-registry/evaluation-client.js +156 -0
- package/dist/skill-registry/evaluation-commands.js +174 -0
- package/dist/skill-registry/messages.js +177 -0
- package/dist/skill-registry/package.js +275 -0
- package/dist/skill-registry/platform-package.js +100 -0
- package/dist/utils/agent-api-client.js +210 -30
- package/dist/utils/environment-endpoints.js +17 -0
- package/dist/utils/error-diagnostics.js +20 -0
- package/dist/utils/playcraft-http-client.js +6 -4
- package/dist/utils/tool-operation-journal.js +124 -0
- package/dist/utils/video-evidence-git.js +81 -0
- package/dist/video-replication/client.js +234 -0
- package/dist/video-replication/comparison-evidence.js +149 -0
- package/dist/video-replication/comparison-files.js +57 -0
- package/dist/video-replication/comparison-log.js +72 -0
- package/dist/video-replication/comparison-messages.js +104 -0
- package/dist/video-replication/comparison-output.js +63 -0
- package/dist/video-replication/comparison-preflight.js +66 -0
- package/dist/video-replication/comparison.js +230 -0
- package/dist/video-replication/diagnostics.js +41 -0
- package/dist/video-replication/evidence.js +165 -0
- package/dist/video-replication/media.js +112 -0
- package/dist/video-replication/messages.js +97 -0
- package/dist/workspace/messages.js +67 -0
- package/dist/workspace/transfer-client.js +237 -0
- package/dist/workspace/transfer-errors.js +48 -0
- package/dist/workspace-runtime/batch/content-changes.js +30 -0
- package/dist/workspace-runtime/batch/control.js +86 -0
- package/dist/workspace-runtime/batch/deliver.js +173 -0
- package/dist/workspace-runtime/batch/freeze.js +101 -0
- package/dist/workspace-runtime/batch/generate.js +249 -0
- package/dist/workspace-runtime/batch/git.js +40 -0
- package/dist/workspace-runtime/batch/occupancy.js +8 -0
- package/dist/workspace-runtime/batch/policy.js +70 -0
- package/dist/workspace-runtime/batch/prepare.js +317 -0
- package/dist/workspace-runtime/batch/processes.js +72 -0
- package/dist/workspace-runtime/batch/records.js +113 -0
- package/dist/workspace-runtime/batch/routes.js +61 -0
- package/dist/workspace-runtime/batch/source-candidate.js +86 -0
- package/dist/workspace-runtime/batch/source-capture.js +146 -0
- package/dist/workspace-runtime/batch/source-failure.js +43 -0
- package/dist/workspace-runtime/batch/source-publish.js +130 -0
- package/dist/workspace-runtime/codex/app-server.js +1065 -0
- package/dist/workspace-runtime/codex/compact.js +46 -0
- package/dist/workspace-runtime/codex/config-toml.js +107 -0
- package/dist/workspace-runtime/codex/delivery-tools.js +144 -0
- package/dist/workspace-runtime/codex/jsonrpc-stdio.js +145 -0
- package/dist/workspace-runtime/codex/launcher-client.js +177 -0
- package/dist/workspace-runtime/codex/loopback.js +146 -0
- package/dist/workspace-runtime/codex/mcp-config.js +39 -0
- package/dist/workspace-runtime/codex/model-broker.js +263 -0
- package/dist/workspace-runtime/codex/native-adapter.js +9 -0
- package/dist/workspace-runtime/codex/permissions.js +79 -0
- package/dist/workspace-runtime/codex/thread-image.js +38 -0
- package/dist/workspace-runtime/codex/tool-response.js +10 -0
- package/dist/workspace-runtime/codex/ui-instructions.js +4 -0
- package/dist/workspace-runtime/codex/ui-tools.js +203 -0
- package/dist/workspace-runtime/codex/work-mode.js +15 -0
- package/dist/workspace-runtime/main.js +10 -0
- package/dist/workspace-runtime/persistence/journal.js +365 -0
- package/dist/workspace-runtime/persistence/native-subagents.js +162 -0
- package/dist/workspace-runtime/persistence/sqlite-client.js +77 -0
- package/dist/workspace-runtime/persistence/sqlite-worker.js +1161 -0
- package/dist/workspace-runtime/persistence/stopped-execution.js +77 -0
- package/dist/workspace-runtime/previews/diagnostics.js +44 -0
- package/dist/workspace-runtime/previews/output.js +36 -0
- package/dist/workspace-runtime/previews/publish.js +283 -0
- package/dist/workspace-runtime/previews/runtime-preview.js +251 -0
- package/dist/workspace-runtime/previews/single-file.js +43 -0
- package/dist/workspace-runtime/processes/managed-writes.js +69 -0
- package/dist/workspace-runtime/serve.js +441 -0
- package/dist/workspace-runtime/server/accept-operation.js +61 -0
- package/dist/workspace-runtime/server/asset-transfers.js +63 -0
- package/dist/workspace-runtime/server/auth.js +21 -0
- package/dist/workspace-runtime/server/connectivity.js +211 -0
- package/dist/workspace-runtime/server/desktop-host.js +429 -0
- package/dist/workspace-runtime/server/desktop-preview-config.js +81 -0
- package/dist/workspace-runtime/server/desktop-preview-service.js +157 -0
- package/dist/workspace-runtime/server/desktop-preview-static.js +53 -0
- package/dist/workspace-runtime/server/desktop-preview.js +189 -0
- package/dist/workspace-runtime/server/dispatch.js +1655 -0
- package/dist/workspace-runtime/server/endpoints.js +21 -0
- package/dist/workspace-runtime/server/execution-group.js +90 -0
- package/dist/workspace-runtime/server/http.js +1339 -0
- package/dist/workspace-runtime/server/lock.js +53 -0
- package/dist/workspace-runtime/server/operation-record.js +33 -0
- package/dist/workspace-runtime/server/rfb-watch-gate.js +168 -0
- package/dist/workspace-runtime/server/session-restore.js +84 -0
- package/dist/workspace-runtime/server/source-uploader.js +138 -0
- package/dist/workspace-runtime/server/submit-operation.js +41 -0
- package/dist/workspace-runtime/server/terminal-host.js +366 -0
- package/dist/workspace-runtime/server/types.js +1 -0
- package/dist/workspace-runtime/server/workspace-transfer.js +168 -0
- package/dist/workspace-runtime/verify-artifact.js +59 -0
- package/dist/workspace-runtime/workspaces/append-only-log.js +62 -0
- package/dist/workspace-runtime/workspaces/archive.js +207 -0
- package/dist/workspace-runtime/workspaces/artifact-events.js +55 -0
- package/dist/workspace-runtime/workspaces/artifact-files.js +199 -0
- package/dist/workspace-runtime/workspaces/artifact-receipts.js +89 -0
- package/dist/workspace-runtime/workspaces/artifacts.js +282 -0
- package/dist/workspace-runtime/workspaces/asset-library-import.js +387 -0
- package/dist/workspace-runtime/workspaces/asset-publication-access.js +25 -0
- package/dist/workspace-runtime/workspaces/asset-transfer-dependencies.js +81 -0
- package/dist/workspace-runtime/workspaces/asset-transfer-publish.js +438 -0
- package/dist/workspace-runtime/workspaces/asset-transfer-storage.js +389 -0
- package/dist/workspace-runtime/workspaces/attachment-content.js +73 -0
- package/dist/workspace-runtime/workspaces/attachments.js +185 -0
- package/dist/workspace-runtime/workspaces/batch-commit.js +142 -0
- package/dist/workspace-runtime/workspaces/binary-content.js +65 -0
- package/dist/workspace-runtime/workspaces/binary-write.js +117 -0
- package/dist/workspace-runtime/workspaces/cli-context.js +23 -0
- package/dist/workspace-runtime/workspaces/cli-credentials.js +115 -0
- package/dist/workspace-runtime/workspaces/composer-context.js +147 -0
- package/dist/workspace-runtime/workspaces/context-error.js +2 -0
- package/dist/workspace-runtime/workspaces/delivery-build.js +331 -0
- package/dist/workspace-runtime/workspaces/delivery-store.js +168 -0
- package/dist/workspace-runtime/workspaces/delivery.js +64 -0
- package/dist/workspace-runtime/workspaces/dependencies.js +279 -0
- package/dist/workspace-runtime/workspaces/developer-command.js +98 -0
- package/dist/workspace-runtime/workspaces/directories.js +132 -0
- package/dist/workspace-runtime/workspaces/directory-access.js +37 -0
- package/dist/workspace-runtime/workspaces/directory-attachments.js +245 -0
- package/dist/workspace-runtime/workspaces/directory-create.js +57 -0
- package/dist/workspace-runtime/workspaces/directory-maintenance.js +111 -0
- package/dist/workspace-runtime/workspaces/directory-mutations.js +238 -0
- package/dist/workspace-runtime/workspaces/directory-revisions.js +56 -0
- package/dist/workspace-runtime/workspaces/directory-stats.js +49 -0
- package/dist/workspace-runtime/workspaces/disk-snapshot.js +31 -0
- package/dist/workspace-runtime/workspaces/empty-template.js +42 -0
- package/dist/workspace-runtime/workspaces/file-content.js +48 -0
- package/dist/workspace-runtime/workspaces/files-search.js +116 -0
- package/dist/workspace-runtime/workspaces/files.js +150 -0
- package/dist/workspace-runtime/workspaces/git-credential-broker.js +312 -0
- package/dist/workspace-runtime/workspaces/git-credential-helper.js +68 -0
- package/dist/workspace-runtime/workspaces/git-direct-store.js +155 -0
- package/dist/workspace-runtime/workspaces/git.js +670 -0
- package/dist/workspace-runtime/workspaces/instructions.js +56 -0
- package/dist/workspace-runtime/workspaces/json5-edit.js +313 -0
- package/dist/workspace-runtime/workspaces/library-attachments.js +268 -0
- package/dist/workspace-runtime/workspaces/operation-log.js +23 -0
- package/dist/workspace-runtime/workspaces/optional-platform-skills.js +14 -0
- package/dist/workspace-runtime/workspaces/parameter-agent-inputs.js +97 -0
- package/dist/workspace-runtime/workspaces/parameter-agent-protocol.js +40 -0
- package/dist/workspace-runtime/workspaces/parameter-agent-store.js +58 -0
- package/dist/workspace-runtime/workspaces/parameter-agent.js +284 -0
- package/dist/workspace-runtime/workspaces/parameter-assets.js +189 -0
- package/dist/workspace-runtime/workspaces/parameters.js +329 -0
- package/dist/workspace-runtime/workspaces/prepare.js +278 -0
- package/dist/workspace-runtime/workspaces/registry.js +251 -0
- package/dist/workspace-runtime/workspaces/remix-references.js +301 -0
- package/dist/workspace-runtime/workspaces/revisions.js +31 -0
- package/dist/workspace-runtime/workspaces/session-image.js +104 -0
- package/dist/workspace-runtime/workspaces/shared-git.js +40 -0
- package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +95 -0
- package/dist/workspace-runtime/workspaces/skills.js +191 -0
- package/dist/workspace-runtime/workspaces/theme-asset-index.js +157 -0
- package/dist/workspace-runtime/workspaces/transfer-quota.js +69 -0
- package/dist/workspace-runtime/workspaces/transfer.js +471 -0
- package/dist/workspace-runtime/workspaces/turn-changes.js +75 -0
- package/dist/workspace-runtime/workspaces/video-attachments.js +49 -0
- package/package.json +15 -5
- package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +25 -0
- package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +79 -0
- package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +29 -0
- package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +37 -0
- package/project-template-v2/.claude/agents/artist.md +82 -0
- package/project-template-v2/.claude/agents/developer.md +153 -0
- package/project-template-v2/.claude/agents/game-designer.md +264 -0
- package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +533 -0
- package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +153 -0
- package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +27 -0
- package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +208 -0
- package/project-template-v2/.claude/agents/refs/atom-skill-library.md +81 -0
- package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +432 -0
- package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +252 -0
- package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +266 -0
- package/project-template-v2/.claude/agents/refs/framework-mda.md +147 -0
- package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +123 -0
- package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +88 -0
- package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +67 -0
- package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +120 -0
- package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +300 -0
- package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +495 -0
- package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +1141 -0
- package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +111 -0
- package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +365 -0
- package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +412 -0
- package/project-template-v2/.claude/agents/reviewer.md +75 -0
- package/project-template-v2/.claude/agents/technical-artist.md +86 -0
- package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +243 -0
- package/project-template-v2/.claude/hooks/user-prompt.mjs +133 -0
- package/project-template-v2/.claude/settings.json +33 -0
- package/project-template-v2/.claude/skills/brainstorming/SKILL.md +161 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +270 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +177 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +354 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +148 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +56 -0
- package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +62 -0
- package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
- package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +309 -0
- package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +182 -0
- package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +123 -0
- package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +205 -0
- package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +280 -0
- package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +184 -0
- package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +306 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +370 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +123 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +254 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +333 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +95 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +118 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +136 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +397 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +296 -0
- package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +122 -0
- package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +219 -0
- package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +373 -0
- package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +161 -0
- package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +215 -0
- package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +382 -0
- package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +423 -0
- package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +158 -0
- package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +100 -0
- package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +167 -0
- package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +270 -0
- package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +236 -0
- package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +130 -0
- package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +390 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +23 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +39 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +87 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +240 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +226 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +308 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +275 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +134 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +142 -0
- package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +153 -0
- package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +386 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +182 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +72 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +121 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +102 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +127 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +106 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +128 -0
- package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +67 -0
- package/project-template-v2/.claude/snapshot.mjs +263 -0
- package/project-template-v2/.playcraft/skills.lock.json +152 -0
- package/project-template-v2/CLAUDE.md +146 -0
- 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 +254 -0
- package/project-template-v2/docs/harness/iteration-1/generate-flow.md +91 -0
- package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +214 -0
- package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +75 -0
- package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +63 -0
- package/project-template-v2/docs/harness/iteration-2/context-flow.md +223 -0
- package/project-template-v2/docs/harness/iteration-2/generate-flow.md +129 -0
- package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +267 -0
- package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +164 -0
- package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +115 -0
- package/project-template-v2/docs/harness/orchestrator-flow.md +364 -0
- package/project-template-v2/docs/project-state.json +60 -0
- package/project-template-v2/docs/project-state.md +72 -0
- package/project-template-v2/docs/standards/README.md +225 -0
- package/project-template-v2/docs/standards/agent-behavior-standards.md +174 -0
- package/project-template-v2/docs/standards/artifacts/design-brief.md +19 -0
- package/project-template-v2/docs/standards/artifacts/design.md +22 -0
- package/project-template-v2/docs/standards/artifacts/game-code.md +41 -0
- package/project-template-v2/docs/standards/artifacts/todo-list.md +41 -0
- package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +343 -0
- package/project-template-v2/game/index.ts +18 -0
- package/project-template-v2/globals.d.ts +51 -0
- package/project-template-v2/index.css +34 -0
- package/project-template-v2/index.html +18 -0
- package/project-template-v2/main.ts +9 -0
- package/project-template-v2/package.json +46 -0
- package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +31 -0
- package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +86 -0
- package/project-template-v2/skills/_shared/scripts/dod-check.mjs +153 -0
- package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +70 -0
- package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +91 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +131 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +80 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +90 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +93 -0
- package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +23 -0
- package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +230 -0
- package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +58 -0
- package/project-template-v2/skills/_shared/scripts/state-get.mjs +339 -0
- package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +39 -0
- package/project-template-v2/skills/_shared/scripts/state-set.mjs +94 -0
- package/project-template-v2/skills/_shared/scripts/state-store.mjs +783 -0
- package/project-template-v2/skills/_shared/scripts/todo-add.mjs +88 -0
- package/project-template-v2/skills/_shared/scripts/todo-get.mjs +130 -0
- package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +33 -0
- package/project-template-v2/skills/_shared/scripts/todo-set.mjs +47 -0
- package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +268 -0
- package/project-template-v2/skills/_shared/scripts/verify-env.mjs +285 -0
- package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +161 -0
- package/project-template-v2/skills/playable-autoplay/SKILL.md +176 -0
- package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +4 -0
- package/project-template-v2/skills/playable-debug/SKILL.md +116 -0
- package/project-template-v2/skills/playable-debug/agents/openai.yaml +4 -0
- package/project-template-v2/skills/playable-debug/references/debug-config.md +40 -0
- package/project-template-v2/skills/playable-record/SKILL.md +140 -0
- package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +104 -0
- package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +141 -0
- package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +425 -0
- package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +261 -0
- package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +398 -0
- package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +322 -0
- package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +105 -0
- package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +230 -0
- package/project-template-v2/skills/playable-validate/SKILL.md +61 -0
- package/project-template-v2/skills/playable-validate/validation-rules.md +14 -0
- package/project-template-v2/skills/playable-verify-ui/SKILL.md +63 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +1 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +218 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +51 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +59 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +106 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +116 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +59 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +64 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +58 -0
- package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +333 -0
- package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
- package/project-template-v2/tsconfig.json +20 -0
- package/project-template-v2/vite.config.ts +27 -0
- package/project-templates/batch-locks/phaser.yaml +922 -0
- package/project-templates/batch-locks/threejs.yaml +978 -0
- package/project-templates/empty/AGENTS.md +41 -0
- package/project-templates/empty/gitignore +33 -0
- package/templates/preview-runtime/v1/README.md +71 -0
- package/templates/preview-runtime/v1/build-preview.mjs +1324 -0
- package/templates/preview-runtime/v1/manifest.json +17 -0
- package/templates/preview-runtime/v1/release-guard.mjs +87 -0
- package/templates/preview-runtime/v1/runtime.d.mts +3 -0
- package/templates/preview-runtime/v1/runtime.d.ts +3 -0
- package/templates/preview-runtime/v1/runtime.mjs +1121 -0
- package/templates/preview-runtime/v1/types/adapters.d.ts +26 -0
- package/templates/preview-runtime/v1/types/preview.d.ts +23 -0
- package/templates/preview-runtime/v1/types/protocol.d.ts +94 -0
- package/templates/preview-runtime/v1/types/runtime.d.ts +14 -0
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { rm, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { statfs } from 'node:fs/promises';
|
|
3
|
+
import { batchSourceFreezeResultSchema, batchSourceRemoteRef, sandboxBatchSourceFreezeRequestSchema, workspaceDiskAdmission, } from '@playcraft/common/cloud-workspace/runtime';
|
|
4
|
+
import { stopBackgroundWriter } from '../processes/managed-writes.js';
|
|
5
|
+
import { workspaceRoot } from '../workspaces/registry.js';
|
|
6
|
+
import { gitRead } from './git.js';
|
|
7
|
+
import { captureIndependentSource } from './source-capture.js';
|
|
8
|
+
import { filesystemObjectStore, readSnapshot, serializeFreeze, sourceCacheDir, writeSnapshot, } from './records.js';
|
|
9
|
+
import { assertSourceIdentity, readSourceCandidate, writeSourceCandidate } from './source-candidate.js';
|
|
10
|
+
import { BatchSourceFreezeError, sourceFreezeError } from './source-failure.js';
|
|
11
|
+
import { publishSourceCandidate } from './source-publish.js';
|
|
12
|
+
async function usagePercent(path) {
|
|
13
|
+
const disk = await statfs(path);
|
|
14
|
+
if (disk.blocks <= 0)
|
|
15
|
+
throw new Error('disk_usage_unavailable');
|
|
16
|
+
return ((disk.blocks - disk.bfree) / disk.blocks) * 100;
|
|
17
|
+
}
|
|
18
|
+
/** Dependency installs are keyed `workspaceId:directoryName`. A bare workspace id is not this directory. */
|
|
19
|
+
async function stopManagedWriters(state, workspaceId, directoryName) {
|
|
20
|
+
const scope = `${workspaceId}:${directoryName}`;
|
|
21
|
+
for (const write of state.journal.listManagedWrites()) {
|
|
22
|
+
if (write.stoppedAt || write.workspaceId !== scope)
|
|
23
|
+
continue;
|
|
24
|
+
if (write.pid !== undefined) {
|
|
25
|
+
const stopped = await stopBackgroundWriter(write.pid);
|
|
26
|
+
if (!stopped)
|
|
27
|
+
continue;
|
|
28
|
+
}
|
|
29
|
+
await state.journal.putManagedWrite({ ...write, stoppedAt: new Date().toISOString() });
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
export async function freezeBatchSource(state, body, options) {
|
|
33
|
+
const parsed = sandboxBatchSourceFreezeRequestSchema.safeParse(body);
|
|
34
|
+
if (!parsed.success)
|
|
35
|
+
throw new Error('invalid_batch_request');
|
|
36
|
+
const request = parsed.data;
|
|
37
|
+
return serializeFreeze(async () => {
|
|
38
|
+
let candidate;
|
|
39
|
+
let source;
|
|
40
|
+
try {
|
|
41
|
+
const pending = await readSourceCandidate(state, request.batchId);
|
|
42
|
+
const existing = await readSnapshot(state, request.batchId);
|
|
43
|
+
if (existing) {
|
|
44
|
+
assertSourceIdentity(state, request, existing, pending);
|
|
45
|
+
return batchSourceFreezeResultSchema.parse({ status: 'frozen', snapshot: existing });
|
|
46
|
+
}
|
|
47
|
+
if (!pending && 'resumeOnly' in request && request.resumeOnly === true) {
|
|
48
|
+
throw await sourceFreezeError(state, request.batchId, { code: 'batch_source_candidate_lost', stage: 'capture', retryable: false, outcome: 'unknown' });
|
|
49
|
+
}
|
|
50
|
+
if (pending)
|
|
51
|
+
assertSourceIdentity(state, request, pending.snapshot, pending);
|
|
52
|
+
source = await workspaceRoot(state, request.workspaceId, request.sourceDirectoryName);
|
|
53
|
+
if (pending)
|
|
54
|
+
candidate = pending;
|
|
55
|
+
else {
|
|
56
|
+
const percent = Math.min(100, Math.max(0, options?.usagePercent ?? await usagePercent(source)));
|
|
57
|
+
if (workspaceDiskAdmission(percent) === 'paused')
|
|
58
|
+
throw new Error('disk_admission_paused');
|
|
59
|
+
await stopManagedWriters(state, request.workspaceId, request.sourceDirectoryName);
|
|
60
|
+
const cache = sourceCacheDir(state, request.batchId);
|
|
61
|
+
await rm(cache, { recursive: true, force: true });
|
|
62
|
+
const captured = await captureIndependentSource(source, cache);
|
|
63
|
+
await writeFile(`${cache}.digest`, captured.digest, { mode: 0o600 });
|
|
64
|
+
const binding = state.journal.getWorkspace(request.workspaceId);
|
|
65
|
+
const snapshot = {
|
|
66
|
+
batchId: request.batchId, commitHash: captured.commitHash, digest: captured.digest,
|
|
67
|
+
sourceWorkspaceId: request.workspaceId, sourceDirectoryName: request.sourceDirectoryName,
|
|
68
|
+
frozenAt: new Date((await gitRead(cache, ['show', '-s', '--format=%cI', 'HEAD'])).trim()).toISOString(),
|
|
69
|
+
...(request.persist === 'remote_ref' ? { remoteRef: batchSourceRemoteRef(request.batchId) }
|
|
70
|
+
: { artifactKey: `workspaces/${request.workspaceId}/batches/${request.batchId}/source/${captured.digest}.json.gz` }),
|
|
71
|
+
};
|
|
72
|
+
candidate = {
|
|
73
|
+
version: 1, persist: request.persist, repositoryUrl: binding?.repositoryUrl ?? undefined, projectId: binding?.projectId,
|
|
74
|
+
branchName: request.sourceDirectoryName === 'basic' ? binding?.branchName ?? undefined
|
|
75
|
+
: binding?.directories?.find(directory => directory.directoryName === request.sourceDirectoryName)?.branchName ?? undefined,
|
|
76
|
+
snapshot,
|
|
77
|
+
};
|
|
78
|
+
await writeSourceCandidate(state, candidate);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
catch (error) {
|
|
82
|
+
if (error instanceof BatchSourceFreezeError)
|
|
83
|
+
throw error;
|
|
84
|
+
const known = new Set(['disk_admission_paused', 'disk_usage_unavailable', 'batch_source_changed', 'batch_source_path_invalid',
|
|
85
|
+
'workspace_not_registered', 'batch_source_identity_mismatch', 'batch_source_snapshot_mismatch']);
|
|
86
|
+
const code = error instanceof Error && known.has(error.message) ? error.message : 'batch_source_capture_failed';
|
|
87
|
+
throw await sourceFreezeError(state, request.batchId, {
|
|
88
|
+
code, stage: 'capture', retryable: !['batch_source_path_invalid', 'batch_source_identity_mismatch', 'batch_source_snapshot_mismatch'].includes(code),
|
|
89
|
+
outcome: code === 'batch_source_identity_mismatch' || code === 'batch_source_snapshot_mismatch' ? 'unknown' : 'not_published',
|
|
90
|
+
}, error);
|
|
91
|
+
}
|
|
92
|
+
await publishSourceCandidate(state, candidate, source, options?.objectStore ?? filesystemObjectStore(state));
|
|
93
|
+
try {
|
|
94
|
+
await writeSnapshot(state, candidate.snapshot);
|
|
95
|
+
}
|
|
96
|
+
catch (error) {
|
|
97
|
+
throw await sourceFreezeError(state, request.batchId, { code: 'batch_source_verification_failed', stage: 'verify', retryable: true, outcome: 'unknown' }, error);
|
|
98
|
+
}
|
|
99
|
+
return batchSourceFreezeResultSchema.parse({ status: 'frozen', snapshot: candidate.snapshot });
|
|
100
|
+
});
|
|
101
|
+
}
|
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { mkdir } from 'node:fs/promises';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
import { setTimeout as delay } from 'node:timers/promises';
|
|
5
|
+
import { hashOperationPayload, operationScopeKey, sandboxBatchMemberGenerateSchema, } from '@playcraft/common/cloud-workspace/runtime';
|
|
6
|
+
import { attachNativeCollector, executeOperation } from '../server/dispatch.js';
|
|
7
|
+
import { workspaceRoot } from '../workspaces/registry.js';
|
|
8
|
+
import { snapshotWorkspaceTree } from '../workspaces/git.js';
|
|
9
|
+
import { requireBatchContentChanges } from './content-changes.js';
|
|
10
|
+
import { bindMemberPolicy, memberExecutionPolicy } from './policy.js';
|
|
11
|
+
import { groupExited, stopProcessGroup } from './processes.js';
|
|
12
|
+
import { memberStatus, readMember, readStopMarker, serializeRun, writeMember } from './records.js';
|
|
13
|
+
function hashCommand(value) {
|
|
14
|
+
return hashOperationPayload(value);
|
|
15
|
+
}
|
|
16
|
+
function operation(state, input) {
|
|
17
|
+
const now = new Date().toISOString();
|
|
18
|
+
const record = {
|
|
19
|
+
operationId: randomUUID(), environment: state.config.environment, userId: state.config.userId,
|
|
20
|
+
clientRequestId: input.clientRequestId, kind: input.kind, status: 'queued', payloadHash: hashOperationPayload(input.payload),
|
|
21
|
+
workspaceId: input.workspaceId, directoryName: input.directoryName, sessionId: input.sessionId,
|
|
22
|
+
generation: state.config.generation, runtimeEpoch: state.runtimeEpoch, leaseFence: state.acceptedLeaseFence,
|
|
23
|
+
createdAt: now, updatedAt: now,
|
|
24
|
+
};
|
|
25
|
+
return { scopeKey: operationScopeKey(record), record };
|
|
26
|
+
}
|
|
27
|
+
function turnTerminal(event) {
|
|
28
|
+
if (event.kind === 'approval_request')
|
|
29
|
+
return 'needs_user';
|
|
30
|
+
if (event.method !== 'turn/completed' && event.method !== 'turn.completed' && event.method !== 'turn.failed' && event.method !== 'turn.interrupted')
|
|
31
|
+
return undefined;
|
|
32
|
+
const turn = event.params && typeof event.params === 'object' ? event.params.turn : undefined;
|
|
33
|
+
if (event.method === 'turn.failed' || turn?.status === 'failed')
|
|
34
|
+
return 'failed';
|
|
35
|
+
if (event.method === 'turn.interrupted' || turn?.status === 'interrupted')
|
|
36
|
+
return 'interrupted';
|
|
37
|
+
return 'completed';
|
|
38
|
+
}
|
|
39
|
+
function threadIdOf(event) {
|
|
40
|
+
const params = event.params && typeof event.params === 'object' ? event.params : undefined;
|
|
41
|
+
return typeof params?.threadId === 'string' ? params.threadId : undefined;
|
|
42
|
+
}
|
|
43
|
+
async function proveStopped(record) {
|
|
44
|
+
let stopped = true;
|
|
45
|
+
for (const process of record.processes) {
|
|
46
|
+
if (process.stopped || groupExited(process.pid))
|
|
47
|
+
process.stopped = true;
|
|
48
|
+
else {
|
|
49
|
+
const did = await stopProcessGroup(process);
|
|
50
|
+
process.stopped = did;
|
|
51
|
+
if (!did)
|
|
52
|
+
stopped = false;
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
return stopped;
|
|
56
|
+
}
|
|
57
|
+
export async function generateBatchMember(state, body) {
|
|
58
|
+
if (!body || typeof body !== 'object' || !('occupancyId' in body) || !body.occupancyId)
|
|
59
|
+
throw new Error('occupancy_required');
|
|
60
|
+
const parsed = sandboxBatchMemberGenerateSchema.safeParse(body);
|
|
61
|
+
if (!parsed.success)
|
|
62
|
+
throw new Error('invalid_batch_request');
|
|
63
|
+
const command = parsed.data;
|
|
64
|
+
const hash = hashCommand(command);
|
|
65
|
+
return serializeRun(command.runId, async () => {
|
|
66
|
+
attachNativeCollector(state);
|
|
67
|
+
const existing = await readMember(state, command.runId);
|
|
68
|
+
if (existing && command.ownerFence < existing.ownerFence)
|
|
69
|
+
throw new Error('stale_owner');
|
|
70
|
+
if (await readStopMarker(state, command.runId))
|
|
71
|
+
return memberStatus(await stoppedRecord(state, command, existing));
|
|
72
|
+
if (existing && existing.ownerFence === command.ownerFence && existing.commandHash?.generate === hash && existing.phase === 'generate' && existing.state !== 'running') {
|
|
73
|
+
return memberStatus(await reconcileGenerate(state, existing));
|
|
74
|
+
}
|
|
75
|
+
if (existing && existing.ownerFence === command.ownerFence && existing.commandHash?.generate && existing.commandHash.generate !== hash)
|
|
76
|
+
throw new Error('batch_command_conflict');
|
|
77
|
+
const root = await workspaceRoot(state, command.workspaceId, command.directoryName);
|
|
78
|
+
const sessionId = command.sessionId ?? existing?.sessionId ?? `member-${command.runId}`;
|
|
79
|
+
const tempDir = join(state.config.stateDir, 'batch-temp', command.runId);
|
|
80
|
+
await mkdir(tempDir, { recursive: true, mode: 0o700 });
|
|
81
|
+
const policy = memberExecutionPolicy(root, tempDir);
|
|
82
|
+
await bindMemberPolicy(state, sessionId, policy);
|
|
83
|
+
const modelConfigId = command.model && /^[0-9a-f-]{36}$/i.test(command.model) ? command.model : undefined;
|
|
84
|
+
const turnPayload = { text: command.prompt, permissionMode: 'auto', ...(modelConfigId ? { modelConfigId } : {}) };
|
|
85
|
+
const turnKey = operation(state, { kind: 'session.turn', clientRequestId: `batch-turn:${command.runId}`, sessionId, workspaceId: command.workspaceId, directoryName: command.directoryName, payload: turnPayload });
|
|
86
|
+
const prior = state.journal.getOperation(turnKey.scopeKey);
|
|
87
|
+
if (prior && prior.payloadHash !== turnKey.record.payloadHash)
|
|
88
|
+
throw new Error('batch_command_conflict');
|
|
89
|
+
const sourceCommit = existing?.sourceCommit ?? state.journal.getWorkspace(command.workspaceId)?.directories?.find(directory => directory.directoryName === command.directoryName)?.sourceCommit;
|
|
90
|
+
const beforeTree = existing?.beforeTree ?? (prior ? sourceCommit : await snapshotWorkspaceTree(root));
|
|
91
|
+
let record = await writeMember(state, {
|
|
92
|
+
runId: command.runId, ownerFence: command.ownerFence, occupancyId: command.occupancyId, workspaceId: command.workspaceId,
|
|
93
|
+
directoryName: command.directoryName, phase: 'generate', state: prior ? (prior.status === 'uncertain' ? 'unknown' : prior.status === 'completed' ? 'completed' : 'running') : 'running',
|
|
94
|
+
writersStopped: false, holding: true, stopRequested: false, processes: existing?.processes ?? [], sessionId,
|
|
95
|
+
operationId: prior?.operationId, commandHash: { ...existing?.commandHash, generate: hash },
|
|
96
|
+
snapshotDigest: existing?.snapshotDigest, branchName: existing?.branchName, headCommit: existing?.headCommit,
|
|
97
|
+
sourceCommit, beforeTree,
|
|
98
|
+
updatedAt: new Date().toISOString(),
|
|
99
|
+
});
|
|
100
|
+
if (prior)
|
|
101
|
+
return memberStatus(await finishGenerate(state, record, prior, root));
|
|
102
|
+
if (!state.native?.ready()) {
|
|
103
|
+
record = await writeMember(state, { ...record, state: 'failed', writersStopped: true, holding: false, error: 'capability_unavailable' });
|
|
104
|
+
return memberStatus(record);
|
|
105
|
+
}
|
|
106
|
+
const terminals = new Map();
|
|
107
|
+
const unsubscribe = state.native.onCollected?.((event) => {
|
|
108
|
+
const threadId = threadIdOf(event);
|
|
109
|
+
const terminal = turnTerminal(event);
|
|
110
|
+
if (!threadId || !terminal)
|
|
111
|
+
return;
|
|
112
|
+
if (terminals.get(threadId) === 'needs_user')
|
|
113
|
+
return;
|
|
114
|
+
terminals.set(threadId, terminal);
|
|
115
|
+
});
|
|
116
|
+
try {
|
|
117
|
+
if (!state.journal.getSession(sessionId)) {
|
|
118
|
+
const created = operation(state, { kind: 'session.create', clientRequestId: `batch-create:${command.runId}`, sessionId, workspaceId: command.workspaceId, directoryName: command.directoryName, payload: { permissionMode: 'auto', ...(modelConfigId ? { modelConfigId } : {}) } });
|
|
119
|
+
if (!state.journal.getOperation(created.scopeKey))
|
|
120
|
+
await executeOperation(state, created.scopeKey, created.record, { permissionMode: 'auto', ...(modelConfigId ? { modelConfigId } : {}) });
|
|
121
|
+
}
|
|
122
|
+
if (await readStopMarker(state, command.runId))
|
|
123
|
+
return memberStatus(await stoppedRecord(state, command, record));
|
|
124
|
+
const started = await executeOperation(state, turnKey.scopeKey, turnKey.record, turnPayload);
|
|
125
|
+
record = await writeMember(state, { ...record, operationId: started.operationId, sessionId });
|
|
126
|
+
return memberStatus(await finishGenerate(state, record, started, root, () => {
|
|
127
|
+
const threadId = state.journal.getSession(sessionId)?.threadId;
|
|
128
|
+
return threadId ? terminals.get(threadId) : undefined;
|
|
129
|
+
}));
|
|
130
|
+
}
|
|
131
|
+
finally {
|
|
132
|
+
unsubscribe?.();
|
|
133
|
+
}
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
async function finishGenerate(state, record, started, root, early) {
|
|
137
|
+
if (await readStopMarker(state, record.runId))
|
|
138
|
+
return stoppedRecord(state, { ...record, occupancyId: record.occupancyId }, record);
|
|
139
|
+
const sessionId = record.sessionId;
|
|
140
|
+
let terminal = early?.();
|
|
141
|
+
if (!terminal && (started.status === 'uncertain' || started.error === 'native_receipt_lost')) {
|
|
142
|
+
return writeMember(state, { ...record, state: 'unknown', writersStopped: false, holding: true, operationId: started.operationId, error: 'native_receipt_lost' });
|
|
143
|
+
}
|
|
144
|
+
if (!terminal && started.status === 'failed') {
|
|
145
|
+
const writersStopped = await proveStopped(record);
|
|
146
|
+
return writeMember(state, { ...record, state: writersStopped ? 'failed' : 'stopping', writersStopped, holding: !writersStopped, operationId: started.operationId, error: started.error ?? 'batch_turn_failed' });
|
|
147
|
+
}
|
|
148
|
+
const deadline = Date.now() + 5_000;
|
|
149
|
+
while (!terminal && Date.now() < deadline) {
|
|
150
|
+
terminal = early?.();
|
|
151
|
+
const session = state.journal.getSession(sessionId);
|
|
152
|
+
if (session?.turnStatus === 'waiting_for_user')
|
|
153
|
+
terminal = 'needs_user';
|
|
154
|
+
else if (session?.turnStatus === 'completed')
|
|
155
|
+
terminal = 'completed';
|
|
156
|
+
else if (session?.turnStatus === 'failed')
|
|
157
|
+
terminal = 'failed';
|
|
158
|
+
else if (session?.turnStatus === 'interrupted')
|
|
159
|
+
terminal = 'interrupted';
|
|
160
|
+
if (!terminal)
|
|
161
|
+
await delay(15);
|
|
162
|
+
}
|
|
163
|
+
if (terminal === 'needs_user') {
|
|
164
|
+
const session = state.journal.getSession(sessionId);
|
|
165
|
+
if (session?.threadId)
|
|
166
|
+
await state.native?.interrupt?.({ sessionId, threadId: session.threadId }).catch(() => undefined);
|
|
167
|
+
const writersStopped = await proveStopped(record);
|
|
168
|
+
if (await readStopMarker(state, record.runId))
|
|
169
|
+
return stoppedRecord(state, record, record);
|
|
170
|
+
return writeMember(state, {
|
|
171
|
+
...record, state: writersStopped ? 'needs_user' : 'stopping', writersStopped, holding: writersStopped ? false : true,
|
|
172
|
+
operationId: started.operationId, error: writersStopped ? 'needs_user' : undefined,
|
|
173
|
+
});
|
|
174
|
+
}
|
|
175
|
+
if (terminal === 'completed') {
|
|
176
|
+
const writersStopped = await proveStopped(record);
|
|
177
|
+
if (!writersStopped)
|
|
178
|
+
return writeMember(state, { ...record, state: 'stopping', writersStopped: false, holding: true, operationId: started.operationId });
|
|
179
|
+
if (await readStopMarker(state, record.runId))
|
|
180
|
+
return stoppedRecord(state, record, record);
|
|
181
|
+
return completeGeneration(state, { ...record, operationId: started.operationId }, root);
|
|
182
|
+
}
|
|
183
|
+
if (!terminal) {
|
|
184
|
+
return writeMember(state, {
|
|
185
|
+
...record, state: 'running', writersStopped: false, holding: true, operationId: started.operationId, error: undefined,
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
const writersStopped = await proveStopped(record);
|
|
189
|
+
return writeMember(state, {
|
|
190
|
+
...record, state: writersStopped ? (terminal === 'interrupted' ? 'stopped' : 'failed') : 'unknown',
|
|
191
|
+
writersStopped, holding: !writersStopped, operationId: started.operationId,
|
|
192
|
+
error: writersStopped ? (terminal === 'interrupted' ? undefined : 'batch_turn_failed') : 'native_receipt_lost',
|
|
193
|
+
});
|
|
194
|
+
}
|
|
195
|
+
/** A later status read finishes a generate turn that was still running when dispatch returned. */
|
|
196
|
+
export async function settleObservedGenerate(state, record) {
|
|
197
|
+
if (record.phase !== 'generate' || record.state !== 'running' || record.stopRequested)
|
|
198
|
+
return record;
|
|
199
|
+
const session = record.sessionId ? state.journal.getSession(record.sessionId) : undefined;
|
|
200
|
+
if (!session || session.turnBlock === 'uncertain' || session.turnStatus === 'starting' || session.turnStatus === 'running')
|
|
201
|
+
return record;
|
|
202
|
+
const terminal = session.turnStatus === 'completed' ? 'completed'
|
|
203
|
+
: session.turnStatus === 'failed' ? 'failed'
|
|
204
|
+
: session.turnStatus === 'interrupted' ? 'interrupted'
|
|
205
|
+
: session.turnStatus === 'waiting_for_user' ? 'needs_user'
|
|
206
|
+
: undefined;
|
|
207
|
+
if (!terminal)
|
|
208
|
+
return record;
|
|
209
|
+
const root = await workspaceRoot(state, record.workspaceId, record.directoryName);
|
|
210
|
+
return finishGenerate(state, record, { operationId: record.operationId, status: 'accepted' }, root, () => terminal);
|
|
211
|
+
}
|
|
212
|
+
async function reconcileGenerate(state, record) {
|
|
213
|
+
const session = record.sessionId ? state.journal.getSession(record.sessionId) : undefined;
|
|
214
|
+
if (record.state === 'unknown' && session?.turnStatus === 'completed') {
|
|
215
|
+
const writersStopped = await proveStopped(record);
|
|
216
|
+
if (writersStopped && !await readStopMarker(state, record.runId)) {
|
|
217
|
+
const root = await workspaceRoot(state, record.workspaceId, record.directoryName);
|
|
218
|
+
return completeGeneration(state, record, root);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
return record;
|
|
222
|
+
}
|
|
223
|
+
async function completeGeneration(state, record, root) {
|
|
224
|
+
try {
|
|
225
|
+
const afterTree = await snapshotWorkspaceTree(root);
|
|
226
|
+
await requireBatchContentChanges(root, record.beforeTree ?? '', afterTree);
|
|
227
|
+
await requireBatchContentChanges(root, record.sourceCommit ?? '', afterTree);
|
|
228
|
+
}
|
|
229
|
+
catch (error) {
|
|
230
|
+
const code = error instanceof Error && /^[a-z0-9_]+$/.test(error.message) ? error.message : 'batch_generation_failed';
|
|
231
|
+
return writeMember(state, { ...record, state: 'failed', writersStopped: true, holding: false, error: code });
|
|
232
|
+
}
|
|
233
|
+
if (await readStopMarker(state, record.runId))
|
|
234
|
+
return stoppedRecord(state, record, record);
|
|
235
|
+
const head = await import('./git.js').then(git => git.gitRead(root, ['rev-parse', 'HEAD'])).then(value => value.trim()).catch(() => record.headCommit);
|
|
236
|
+
return writeMember(state, { ...record, state: 'completed', writersStopped: true, holding: true, headCommit: head, error: undefined });
|
|
237
|
+
}
|
|
238
|
+
async function stoppedRecord(state, command, existing) {
|
|
239
|
+
if (existing)
|
|
240
|
+
await proveStopped(existing);
|
|
241
|
+
return writeMember(state, {
|
|
242
|
+
runId: command.runId, ownerFence: command.ownerFence, occupancyId: command.occupancyId, workspaceId: command.workspaceId,
|
|
243
|
+
directoryName: command.directoryName, phase: existing?.phase ?? 'generate', state: 'stopped', writersStopped: true, holding: false,
|
|
244
|
+
stopRequested: true, processes: existing?.processes ?? [], sessionId: existing?.sessionId, operationId: existing?.operationId,
|
|
245
|
+
headCommit: existing?.headCommit, evidence: existing?.evidence, commandHash: existing?.commandHash, snapshotDigest: existing?.snapshotDigest,
|
|
246
|
+
branchName: existing?.branchName, updatedAt: new Date().toISOString(),
|
|
247
|
+
sourceCommit: existing?.sourceCommit, beforeTree: existing?.beforeTree,
|
|
248
|
+
});
|
|
249
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { execFile } from 'node:child_process';
|
|
2
|
+
import { promisify } from 'node:util';
|
|
3
|
+
import { dirname } from 'node:path';
|
|
4
|
+
const execute = promisify(execFile);
|
|
5
|
+
/** Read-only git. An empty credential helper keeps the source checkout from authenticating or writing. */
|
|
6
|
+
export async function gitRead(root, args) {
|
|
7
|
+
return runGit(root, ['-c', 'credential.helper=', ...args]);
|
|
8
|
+
}
|
|
9
|
+
/** Push and fetch. Local credential helpers copied onto this repo stay in effect. */
|
|
10
|
+
export async function gitWrite(root, args) {
|
|
11
|
+
return runGit(root, args);
|
|
12
|
+
}
|
|
13
|
+
async function runGit(root, args) {
|
|
14
|
+
const { stdout } = await execute('git', [
|
|
15
|
+
'-c', 'core.hooksPath=/dev/null', '-c', 'init.templateDir=', '-c', 'core.fsmonitor=false', '-C', root, ...args,
|
|
16
|
+
], {
|
|
17
|
+
timeout: 90_000, maxBuffer: 64 * 1024 * 1024,
|
|
18
|
+
env: {
|
|
19
|
+
PATH: process.env.PATH, HOME: dirname(root), GIT_OPTIONAL_LOCKS: '0',
|
|
20
|
+
GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1', GIT_TERMINAL_PROMPT: '0',
|
|
21
|
+
},
|
|
22
|
+
});
|
|
23
|
+
return stdout;
|
|
24
|
+
}
|
|
25
|
+
/** Copies URL credential helpers onto a snapshot repo without reading or writing the source config. */
|
|
26
|
+
export async function copyCredentialHelpers(sourceRoot, destinationRoot) {
|
|
27
|
+
const listed = await gitRead(sourceRoot, ['config', '--local', '--get-regexp', '^(credential\\.|http\\.|url\\.)']).catch(() => '');
|
|
28
|
+
for (const line of listed.split('\n')) {
|
|
29
|
+
if (!line)
|
|
30
|
+
continue;
|
|
31
|
+
const space = line.indexOf(' ');
|
|
32
|
+
if (space < 1)
|
|
33
|
+
continue;
|
|
34
|
+
const key = line.slice(0, space);
|
|
35
|
+
const value = line.slice(space + 1);
|
|
36
|
+
if (!/^(credential\.|http\.|url\.)/.test(key) || /[\r\n]/.test(value))
|
|
37
|
+
continue;
|
|
38
|
+
await gitWrite(destinationRoot, ['config', '--local', key, value]);
|
|
39
|
+
}
|
|
40
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { listMembers } from './records.js';
|
|
2
|
+
/** True while a member Run still holds the directory. Other sandbox write entries must refuse it. */
|
|
3
|
+
export async function batchDirectoryHeld(state, workspaceId, directoryName = 'basic') {
|
|
4
|
+
if (!workspaceId)
|
|
5
|
+
return false;
|
|
6
|
+
const members = await listMembers(state);
|
|
7
|
+
return members.some(record => record.holding && record.workspaceId === workspaceId && record.directoryName === directoryName);
|
|
8
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { readFileSync, mkdirSync, writeFileSync, renameSync } from 'node:fs';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
import { dirname, join } from 'node:path';
|
|
4
|
+
const memory = new WeakMap();
|
|
5
|
+
/** Unattended member execution: workspace-write to the member directory and one controlled temp dir. */
|
|
6
|
+
export function memberExecutionPolicy(cwd, tempDir) {
|
|
7
|
+
return {
|
|
8
|
+
cwd,
|
|
9
|
+
approvalPolicy: 'never',
|
|
10
|
+
sandboxPolicy: {
|
|
11
|
+
type: 'workspaceWrite',
|
|
12
|
+
writableRoots: [cwd, tempDir],
|
|
13
|
+
networkAccess: true,
|
|
14
|
+
excludeTmpdirEnvVar: true,
|
|
15
|
+
excludeSlashTmp: true,
|
|
16
|
+
},
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
function policyPath(state, sessionId) {
|
|
20
|
+
return join(state.config.stateDir, 'batch-sessions', `${sessionId.replace(/[^a-zA-Z0-9._-]/g, '_')}.json`);
|
|
21
|
+
}
|
|
22
|
+
function parsePolicy(raw) {
|
|
23
|
+
const value = JSON.parse(raw);
|
|
24
|
+
if (value?.approvalPolicy !== 'never' || value.sandboxPolicy?.type !== 'workspaceWrite')
|
|
25
|
+
return undefined;
|
|
26
|
+
if (!value.cwd || !Array.isArray(value.sandboxPolicy.writableRoots) || value.sandboxPolicy.writableRoots.length === 0)
|
|
27
|
+
return undefined;
|
|
28
|
+
if (!value.sandboxPolicy.excludeSlashTmp || !value.sandboxPolicy.excludeTmpdirEnvVar)
|
|
29
|
+
return undefined;
|
|
30
|
+
return value;
|
|
31
|
+
}
|
|
32
|
+
export async function bindMemberPolicy(state, sessionId, policy) {
|
|
33
|
+
const path = policyPath(state, sessionId);
|
|
34
|
+
mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
|
|
35
|
+
const temporary = `${path}.${randomUUID()}.tmp`;
|
|
36
|
+
writeFileSync(temporary, JSON.stringify(policy), { mode: 0o600 });
|
|
37
|
+
renameSync(temporary, path);
|
|
38
|
+
const map = memory.get(state) ?? new Map();
|
|
39
|
+
map.set(sessionId, policy);
|
|
40
|
+
memory.set(state, map);
|
|
41
|
+
}
|
|
42
|
+
/** Synchronous: the shared session adapter reapplies this on every thread start and resume. */
|
|
43
|
+
export function trustedMemberPolicy(state, sessionId) {
|
|
44
|
+
const cached = memory.get(state)?.get(sessionId);
|
|
45
|
+
if (cached)
|
|
46
|
+
return cached;
|
|
47
|
+
try {
|
|
48
|
+
const parsed = parsePolicy(readFileSync(policyPath(state, sessionId), 'utf8'));
|
|
49
|
+
if (!parsed) {
|
|
50
|
+
return {
|
|
51
|
+
cwd: state.config.workspaceRoot,
|
|
52
|
+
approvalPolicy: 'never',
|
|
53
|
+
sandboxPolicy: { type: 'readOnly', networkAccess: false },
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
const map = memory.get(state) ?? new Map();
|
|
57
|
+
map.set(sessionId, parsed);
|
|
58
|
+
memory.set(state, map);
|
|
59
|
+
return parsed;
|
|
60
|
+
}
|
|
61
|
+
catch (error) {
|
|
62
|
+
if (error.code === 'ENOENT')
|
|
63
|
+
return undefined;
|
|
64
|
+
return {
|
|
65
|
+
cwd: state.config.workspaceRoot,
|
|
66
|
+
approvalPolicy: 'never',
|
|
67
|
+
sandboxPolicy: { type: 'readOnly', networkAccess: false },
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
}
|