@playcraft/cli 0.1.39-prod → 0.1.40-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 +58 -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/image.js +2 -6
- 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/skills.js +4 -0
- package/dist/commands/tools-3d.js +11 -0
- package/dist/commands/tools-batch.js +87 -0
- package/dist/commands/tools-generation.js +68 -126
- package/dist/commands/tools.js +2 -2
- package/dist/commands/video.js +111 -0
- package/dist/commands/workspace-runtime.js +54 -0
- package/dist/commands/workspace.js +35 -0
- package/dist/config.js +59 -4
- package/dist/index.js +40 -3
- 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 +185 -30
- package/dist/utils/environment-endpoints.js +17 -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 +222 -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 +216 -0
- package/dist/video-replication/evidence.js +165 -0
- package/dist/video-replication/media.js +111 -0
- package/dist/video-replication/messages.js +89 -0
- package/dist/workspace/messages.js +35 -0
- package/dist/workspace/transfer-client.js +174 -0
- package/dist/workspace-runtime/codex/app-server.js +1040 -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/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 +70 -0
- package/dist/workspace-runtime/codex/thread-image.js +38 -0
- package/dist/workspace-runtime/codex/ui-instructions.js +4 -0
- package/dist/workspace-runtime/codex/ui-tools.js +183 -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/output.js +36 -0
- package/dist/workspace-runtime/previews/publish.js +262 -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/production/content-changes.js +36 -0
- package/dist/workspace-runtime/production/contracts.js +19 -0
- package/dist/workspace-runtime/production/controller.js +218 -0
- package/dist/workspace-runtime/production/dependencies.js +60 -0
- package/dist/workspace-runtime/production/native.js +212 -0
- package/dist/workspace-runtime/production/processes.js +102 -0
- package/dist/workspace-runtime/production/save-command.js +35 -0
- package/dist/workspace-runtime/production/source-archive.js +137 -0
- package/dist/workspace-runtime/production/source-copy.js +91 -0
- package/dist/workspace-runtime/production/stages.js +334 -0
- package/dist/workspace-runtime/production/storage.js +75 -0
- package/dist/workspace-runtime/serve.js +214 -0
- package/dist/workspace-runtime/server/auth.js +21 -0
- package/dist/workspace-runtime/server/connectivity.js +201 -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 +1217 -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 +1243 -0
- package/dist/workspace-runtime/server/lock.js +53 -0
- package/dist/workspace-runtime/server/rfb-watch-gate.js +168 -0
- package/dist/workspace-runtime/server/source-uploader.js +138 -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 +99 -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 +197 -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/attachment-content.js +123 -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/cli-context.js +23 -0
- package/dist/workspace-runtime/workspaces/cli-credentials.js +111 -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/dependencies.js +264 -0
- package/dist/workspace-runtime/workspaces/developer-command.js +64 -0
- package/dist/workspace-runtime/workspaces/directories.js +133 -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-maintenance.js +111 -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/files-search.js +116 -0
- package/dist/workspace-runtime/workspaces/files.js +138 -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 +170 -0
- package/dist/workspace-runtime/workspaces/library-attachments.js +268 -0
- package/dist/workspace-runtime/workspaces/optional-platform-skills.js +14 -0
- package/dist/workspace-runtime/workspaces/parameters.js +272 -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/transfer.js +288 -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/agents/refs/ta-image-generation-detail.md +123 -67
- package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +63 -135
- package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +33 -42
- package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +20 -18
- package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +7 -6
- package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- 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 +298 -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 +324 -0
- package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +97 -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 +137 -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/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +63 -135
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +33 -42
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +20 -18
- package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +7 -6
- 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 +63 -135
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +33 -42
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +20 -18
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +7 -6
- package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
- package/dist/commands/tools-image-context.js +0 -23
- package/dist/utils/image-asset-context.js +0 -106
|
@@ -0,0 +1,365 @@
|
|
|
1
|
+
import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { existsSync } from 'node:fs';
|
|
3
|
+
import { dirname, join } from 'node:path';
|
|
4
|
+
import { workspaceRegistrationSchema, operationRecordSchema, pendingSourceEventSchema, replayPinResultSchema, retainedRangeHasGap, sourceAckSchema, sourceEventKey, sourceEventReceiptSchema, terminalRecordSchema, } from '@playcraft/common/cloud-workspace/runtime';
|
|
5
|
+
import { SqliteWorkerClient } from './sqlite-client.js';
|
|
6
|
+
export const RUNTIME_STATE_FILE = 'runtime-state.sqlite';
|
|
7
|
+
export const LEGACY_JOURNAL_FILE = 'journal.json';
|
|
8
|
+
export const LEGACY_JOURNAL_SENTINEL = 'PLAYCRAFT_RUNTIME_STATE_SQLITE\n';
|
|
9
|
+
export class RuntimeJournal {
|
|
10
|
+
filePath;
|
|
11
|
+
legacyPath;
|
|
12
|
+
client;
|
|
13
|
+
listeners = new Set();
|
|
14
|
+
maintenance;
|
|
15
|
+
engineInfo;
|
|
16
|
+
epochs = [];
|
|
17
|
+
readToken = '';
|
|
18
|
+
inboxPending = 0;
|
|
19
|
+
locks = new Map();
|
|
20
|
+
snapshot = emptySnapshot();
|
|
21
|
+
constructor(stateDir) {
|
|
22
|
+
this.filePath = join(stateDir, RUNTIME_STATE_FILE);
|
|
23
|
+
this.legacyPath = join(stateDir, LEGACY_JOURNAL_FILE);
|
|
24
|
+
}
|
|
25
|
+
async exclusive(key, action) {
|
|
26
|
+
const previous = this.locks.get(key) ?? Promise.resolve();
|
|
27
|
+
let release;
|
|
28
|
+
const current = new Promise((resolve) => {
|
|
29
|
+
release = resolve;
|
|
30
|
+
});
|
|
31
|
+
this.locks.set(key, current);
|
|
32
|
+
await previous;
|
|
33
|
+
try {
|
|
34
|
+
return await action();
|
|
35
|
+
}
|
|
36
|
+
finally {
|
|
37
|
+
release();
|
|
38
|
+
if (this.locks.get(key) === current)
|
|
39
|
+
this.locks.delete(key);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
async load() {
|
|
43
|
+
await mkdir(dirname(this.filePath), { recursive: true, mode: 0o700 });
|
|
44
|
+
const legacy = await readLegacy(this.legacyPath, this.filePath);
|
|
45
|
+
const started = await SqliteWorkerClient.open(this.filePath, legacy?.value ?? null);
|
|
46
|
+
this.client = started.client;
|
|
47
|
+
this.apply(started.opened);
|
|
48
|
+
if (legacy?.readable)
|
|
49
|
+
await writeFile(this.legacyPath, LEGACY_JOURNAL_SENTINEL, { mode: 0o600 });
|
|
50
|
+
this.maintenance = setInterval(() => {
|
|
51
|
+
void this.client?.request('maintain').catch(() => undefined);
|
|
52
|
+
}, 30_000);
|
|
53
|
+
this.maintenance.unref?.();
|
|
54
|
+
}
|
|
55
|
+
async close() {
|
|
56
|
+
if (this.maintenance)
|
|
57
|
+
clearInterval(this.maintenance);
|
|
58
|
+
await this.client?.close();
|
|
59
|
+
this.client = undefined;
|
|
60
|
+
}
|
|
61
|
+
engine() {
|
|
62
|
+
if (!this.engineInfo)
|
|
63
|
+
throw new Error('sqlite_engine_unavailable');
|
|
64
|
+
return this.engineInfo;
|
|
65
|
+
}
|
|
66
|
+
sourceReadToken() {
|
|
67
|
+
return this.readToken;
|
|
68
|
+
}
|
|
69
|
+
pendingInbox() {
|
|
70
|
+
return this.inboxPending;
|
|
71
|
+
}
|
|
72
|
+
epochsSnapshot() {
|
|
73
|
+
return this.epochs.map((epoch) => ({ ...epoch }));
|
|
74
|
+
}
|
|
75
|
+
onSourceEvent(listener) {
|
|
76
|
+
this.listeners.add(listener);
|
|
77
|
+
return () => this.listeners.delete(listener);
|
|
78
|
+
}
|
|
79
|
+
getWorkspace(workspaceId) {
|
|
80
|
+
return this.snapshot.workspaces[workspaceId];
|
|
81
|
+
}
|
|
82
|
+
async putWorkspace(binding) {
|
|
83
|
+
const parsed = workspaceRegistrationSchema.parse(binding);
|
|
84
|
+
await this.run('upsertRecord', { bucket: 'workspaces', key: parsed.workspaceId, body: parsed });
|
|
85
|
+
}
|
|
86
|
+
async forgetWorkspaces() {
|
|
87
|
+
await this.run('forgetWorkspaces', {});
|
|
88
|
+
}
|
|
89
|
+
findSessionCreation(sessionId) {
|
|
90
|
+
return Object.values(this.snapshot.operations).find((item) => item.kind === 'session.create' && item.sessionId === sessionId);
|
|
91
|
+
}
|
|
92
|
+
findTerminalCreation(terminalId) {
|
|
93
|
+
return Object.values(this.snapshot.operations).find((item) => item.kind === 'terminal.create' && item.terminalId === terminalId);
|
|
94
|
+
}
|
|
95
|
+
getOperation(scopeKey) {
|
|
96
|
+
return this.snapshot.operations[scopeKey];
|
|
97
|
+
}
|
|
98
|
+
getOperationById(operationId) {
|
|
99
|
+
return Object.values(this.snapshot.operations).find((operation) => operation.operationId === operationId);
|
|
100
|
+
}
|
|
101
|
+
listOperations() {
|
|
102
|
+
return Object.entries(this.snapshot.operations).map(([scopeKey, operation]) => ({ scopeKey, operation }));
|
|
103
|
+
}
|
|
104
|
+
getReceipt(key) {
|
|
105
|
+
return this.snapshot.receipts[key];
|
|
106
|
+
}
|
|
107
|
+
getSession(sessionId) {
|
|
108
|
+
return this.snapshot.sessions[sessionId];
|
|
109
|
+
}
|
|
110
|
+
listSessions() {
|
|
111
|
+
return Object.values(this.snapshot.sessions);
|
|
112
|
+
}
|
|
113
|
+
getTerminal(terminalId) {
|
|
114
|
+
return this.snapshot.terminals[terminalId];
|
|
115
|
+
}
|
|
116
|
+
listTerminals(workspaceId) {
|
|
117
|
+
return Object.values(this.snapshot.terminals).filter((item) => !workspaceId || item.workspaceId === workspaceId);
|
|
118
|
+
}
|
|
119
|
+
listManagedWrites(workspaceId) {
|
|
120
|
+
return Object.values(this.snapshot.managedWrites).filter((item) => !workspaceId || item.workspaceId === workspaceId);
|
|
121
|
+
}
|
|
122
|
+
getManagedWrite(writeId) {
|
|
123
|
+
return this.snapshot.managedWrites[writeId];
|
|
124
|
+
}
|
|
125
|
+
async putManagedWrite(record) {
|
|
126
|
+
await this.run('upsertRecord', { bucket: 'managed_writes', key: record.writeId, body: record });
|
|
127
|
+
}
|
|
128
|
+
getWorkspaceDependencies(workspaceId) {
|
|
129
|
+
return this.snapshot.workspaceDependencies[workspaceId];
|
|
130
|
+
}
|
|
131
|
+
listWorkspaceDependencies() {
|
|
132
|
+
return Object.values(this.snapshot.workspaceDependencies);
|
|
133
|
+
}
|
|
134
|
+
async putWorkspaceDependencies(record) {
|
|
135
|
+
await this.run('upsertRecord', {
|
|
136
|
+
bucket: 'workspace_dependencies',
|
|
137
|
+
key: record.workspaceId,
|
|
138
|
+
body: record,
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
fileRevisions(workspaceId) {
|
|
142
|
+
return { ...(workspaceId ? this.snapshot.workspaceFileRevisions[workspaceId] ?? {} : this.snapshot.fileRevisions) };
|
|
143
|
+
}
|
|
144
|
+
fileRevision(path, workspaceId) {
|
|
145
|
+
return this.fileRevisions(workspaceId)[path]?.revision ?? 0;
|
|
146
|
+
}
|
|
147
|
+
destroyed() {
|
|
148
|
+
return this.snapshot.destroyed;
|
|
149
|
+
}
|
|
150
|
+
lastSourceSequence() {
|
|
151
|
+
return this.snapshot.lastSourceSequence;
|
|
152
|
+
}
|
|
153
|
+
acceptedLeaseFence() {
|
|
154
|
+
return this.snapshot.acceptedLeaseFence;
|
|
155
|
+
}
|
|
156
|
+
storedRuntimeEpoch() {
|
|
157
|
+
return this.snapshot.runtimeEpoch;
|
|
158
|
+
}
|
|
159
|
+
executionGroup() {
|
|
160
|
+
return { ...this.snapshot.executionGroup };
|
|
161
|
+
}
|
|
162
|
+
stoppedRuntimeEpochs() {
|
|
163
|
+
return [...(this.snapshot.stoppedRuntimeEpochs ?? [])];
|
|
164
|
+
}
|
|
165
|
+
getApproval(sessionId, approvalId) {
|
|
166
|
+
return this.snapshot.approvals[`${sessionId}:${approvalId}`];
|
|
167
|
+
}
|
|
168
|
+
listApprovals() {
|
|
169
|
+
return Object.values(this.snapshot.approvals);
|
|
170
|
+
}
|
|
171
|
+
async putApproval(approval) {
|
|
172
|
+
await this.run('upsertRecord', { bucket: 'approvals', key: `${approval.sessionId}:${approval.approvalId}`, body: approval });
|
|
173
|
+
}
|
|
174
|
+
async noteExecutionGroup(group) {
|
|
175
|
+
await this.run('noteExecutionGroup', { group });
|
|
176
|
+
}
|
|
177
|
+
async writeExecutionEpoch(input) {
|
|
178
|
+
await this.run('writeExecutionEpoch', input);
|
|
179
|
+
}
|
|
180
|
+
async setExecutionStopConfirmed(stopConfirmed) {
|
|
181
|
+
await this.run('setStopConfirmed', { stopConfirmed });
|
|
182
|
+
}
|
|
183
|
+
async bindRuntime(input) {
|
|
184
|
+
await this.run('bindRuntime', input);
|
|
185
|
+
}
|
|
186
|
+
listEvents(afterSequence = 0) {
|
|
187
|
+
return Object.values(this.snapshot.events)
|
|
188
|
+
.filter((event) => event.source.sourceSequence > afterSequence)
|
|
189
|
+
.sort((left, right) => left.source.sourceSequence - right.source.sourceSequence || left.source.runtimeEpoch - right.source.runtimeEpoch);
|
|
190
|
+
}
|
|
191
|
+
readSourcePage(input) {
|
|
192
|
+
const epoch = this.epochs.find((item) => item.runtime_id === input.runtimeId && item.generation === input.generation && item.runtime_epoch === input.runtimeEpoch);
|
|
193
|
+
const retainedFrom = epoch?.retained_from ?? 1;
|
|
194
|
+
const highWater = epoch?.local_durable_through ?? 0;
|
|
195
|
+
const coveredThrough = input.after;
|
|
196
|
+
if (retainedRangeHasGap(retainedFrom, coveredThrough)) {
|
|
197
|
+
return { ok: false, code: 'source_gap', retainedFrom, highWater, coveredThrough, ...identity(input) };
|
|
198
|
+
}
|
|
199
|
+
const matched = Object.values(this.snapshot.events)
|
|
200
|
+
.filter((event) => event.source.runtimeId === input.runtimeId &&
|
|
201
|
+
event.source.generation === input.generation &&
|
|
202
|
+
event.source.runtimeEpoch === input.runtimeEpoch &&
|
|
203
|
+
event.source.sourceSequence > input.after)
|
|
204
|
+
.sort((left, right) => left.source.sourceSequence - right.source.sourceSequence);
|
|
205
|
+
const first = matched[0];
|
|
206
|
+
if (first && first.source.sourceSequence > input.after + 1) {
|
|
207
|
+
return { ok: false, code: 'source_gap', retainedFrom, highWater, coveredThrough, ...identity(input) };
|
|
208
|
+
}
|
|
209
|
+
const events = matched.slice(0, input.limit ?? 100);
|
|
210
|
+
const nextAfter = events.at(-1)?.source.sourceSequence ?? input.after;
|
|
211
|
+
return { ok: true, events, retainedFrom, highWater, nextAfter, ...identity(input) };
|
|
212
|
+
}
|
|
213
|
+
async allocateSourceEvent(input) {
|
|
214
|
+
const result = await this.run('allocateEvent', input);
|
|
215
|
+
const event = result.committedEvents?.[0];
|
|
216
|
+
if (!event)
|
|
217
|
+
throw new Error('source_event_missing');
|
|
218
|
+
return event;
|
|
219
|
+
}
|
|
220
|
+
async commitSourceIdentity(event) {
|
|
221
|
+
await this.run('commitIdentity', { event: pendingSourceEventSchema.parse(event) });
|
|
222
|
+
}
|
|
223
|
+
async ingestNative(input) {
|
|
224
|
+
const result = await this.run('ingest', input);
|
|
225
|
+
return result.committedEvents ?? [];
|
|
226
|
+
}
|
|
227
|
+
async bindTurn(input) {
|
|
228
|
+
const result = await this.run('bindTurn', input);
|
|
229
|
+
return result.committedEvents ?? [];
|
|
230
|
+
}
|
|
231
|
+
async acknowledgeSource(ack) {
|
|
232
|
+
await this.run('ack', sourceAckSchema.parse(ack));
|
|
233
|
+
}
|
|
234
|
+
async createReplayPin(input) {
|
|
235
|
+
const result = await this.run('createPin', { identity: input, ttlMs: input.ttlMs });
|
|
236
|
+
return replayPinResultSchema.parse(result.pin);
|
|
237
|
+
}
|
|
238
|
+
async deleteReplayPin(pinId) {
|
|
239
|
+
await this.run('deletePin', { pinId });
|
|
240
|
+
}
|
|
241
|
+
async reclaimSourceEvents(minRetainMs = 0) {
|
|
242
|
+
await this.run('reclaim', { minRetainMs });
|
|
243
|
+
}
|
|
244
|
+
async putOperation(scopeKey, operation) {
|
|
245
|
+
const parsed = operationRecordSchema.parse(operation);
|
|
246
|
+
await this.run('putOperation', { scopeKey, operation: parsed });
|
|
247
|
+
return this.snapshot.operations[scopeKey] ?? parsed;
|
|
248
|
+
}
|
|
249
|
+
async putSession(binding) {
|
|
250
|
+
await this.run('upsertRecord', { bucket: 'sessions', key: binding.sessionId, body: binding });
|
|
251
|
+
}
|
|
252
|
+
async putTerminal(record) {
|
|
253
|
+
const parsed = terminalRecordSchema.parse(record);
|
|
254
|
+
await this.run('upsertRecord', { bucket: 'terminals', key: parsed.terminalId, body: parsed });
|
|
255
|
+
return parsed;
|
|
256
|
+
}
|
|
257
|
+
async putFileRevision(path, record, workspaceId) {
|
|
258
|
+
if (workspaceId) {
|
|
259
|
+
await this.run('upsertRecord', { bucket: `workspace_files:${workspaceId}`, key: path, body: record });
|
|
260
|
+
return;
|
|
261
|
+
}
|
|
262
|
+
await this.run('upsertRecord', { bucket: 'file_revisions', key: path, body: record });
|
|
263
|
+
}
|
|
264
|
+
async markDestroyed() {
|
|
265
|
+
await this.run('setDestroyed', {});
|
|
266
|
+
}
|
|
267
|
+
async replaceSessions(sessions) {
|
|
268
|
+
await this.run('replaceBucket', {
|
|
269
|
+
bucket: 'sessions',
|
|
270
|
+
entries: sessions.map((session) => ({ key: session.sessionId, body: session })),
|
|
271
|
+
});
|
|
272
|
+
}
|
|
273
|
+
async setAcceptedLeaseFence(value) {
|
|
274
|
+
await this.run('setAcceptedFence', { value });
|
|
275
|
+
}
|
|
276
|
+
async putReceipt(receipt, sourceSequence) {
|
|
277
|
+
const parsed = sourceEventReceiptSchema.parse(receipt);
|
|
278
|
+
await this.run('upsertRecord', { bucket: 'receipts', key: sourceEventKey(parsed.source), body: parsed });
|
|
279
|
+
void sourceSequence;
|
|
280
|
+
}
|
|
281
|
+
async appendEvent(event) {
|
|
282
|
+
const parsed = pendingSourceEventSchema.parse(event);
|
|
283
|
+
await this.commitSourceIdentity(parsed);
|
|
284
|
+
return this.snapshot.events[sourceEventKey(parsed.source)] ?? parsed;
|
|
285
|
+
}
|
|
286
|
+
async run(type, payload) {
|
|
287
|
+
if (!this.client)
|
|
288
|
+
throw new Error('sqlite_not_open');
|
|
289
|
+
const result = await this.client.request(type, payload);
|
|
290
|
+
this.apply(result);
|
|
291
|
+
for (const event of result.committedEvents ?? []) {
|
|
292
|
+
for (const listener of this.listeners)
|
|
293
|
+
listener(event);
|
|
294
|
+
}
|
|
295
|
+
return result;
|
|
296
|
+
}
|
|
297
|
+
apply(dump) {
|
|
298
|
+
const group = dump.snapshot.executionGroup;
|
|
299
|
+
const events = dump.snapshot.events ?? this.snapshot.events;
|
|
300
|
+
// Keep history in place: copying it on every streamed delta grows quadratically.
|
|
301
|
+
for (const event of dump.committedEvents ?? [])
|
|
302
|
+
events[sourceEventKey(event.source)] = event;
|
|
303
|
+
for (const event of dump.eventChanges ?? [])
|
|
304
|
+
events[sourceEventKey(event.source)] = event;
|
|
305
|
+
this.snapshot = {
|
|
306
|
+
...emptySnapshot(),
|
|
307
|
+
...dump.snapshot,
|
|
308
|
+
events,
|
|
309
|
+
executionGroup: {
|
|
310
|
+
stopConfirmed: group?.stopConfirmed === true,
|
|
311
|
+
replaced: group?.replaced === true,
|
|
312
|
+
pid: group?.pid,
|
|
313
|
+
startedAt: group?.startedAt,
|
|
314
|
+
previousPid: group?.previousPid,
|
|
315
|
+
},
|
|
316
|
+
};
|
|
317
|
+
this.epochs = dump.epochs ?? [];
|
|
318
|
+
this.readToken = dump.sourceReadToken ?? this.readToken;
|
|
319
|
+
this.inboxPending = dump.pendingInbox ?? 0;
|
|
320
|
+
if (dump.engine)
|
|
321
|
+
this.engineInfo = dump.engine;
|
|
322
|
+
}
|
|
323
|
+
}
|
|
324
|
+
async function readLegacy(legacyPath, sqlitePath) {
|
|
325
|
+
if (!existsSync(legacyPath))
|
|
326
|
+
return null;
|
|
327
|
+
const text = await readFile(legacyPath, 'utf8');
|
|
328
|
+
if (text.startsWith(LEGACY_JOURNAL_SENTINEL.trim())) {
|
|
329
|
+
if (!existsSync(sqlitePath))
|
|
330
|
+
throw new Error('runtime_state_missing');
|
|
331
|
+
return null;
|
|
332
|
+
}
|
|
333
|
+
let value;
|
|
334
|
+
try {
|
|
335
|
+
value = JSON.parse(text);
|
|
336
|
+
}
|
|
337
|
+
catch {
|
|
338
|
+
throw new Error('legacy_journal_unreadable');
|
|
339
|
+
}
|
|
340
|
+
if (!existsSync(`${legacyPath}.bak`))
|
|
341
|
+
await copyFile(legacyPath, `${legacyPath}.bak`);
|
|
342
|
+
return { value, readable: true };
|
|
343
|
+
}
|
|
344
|
+
function identity(input) {
|
|
345
|
+
return { runtimeId: input.runtimeId, generation: input.generation, runtimeEpoch: input.runtimeEpoch };
|
|
346
|
+
}
|
|
347
|
+
function emptySnapshot() {
|
|
348
|
+
return {
|
|
349
|
+
workspaces: {},
|
|
350
|
+
workspaceFileRevisions: {},
|
|
351
|
+
operations: {},
|
|
352
|
+
receipts: {},
|
|
353
|
+
events: {},
|
|
354
|
+
sessions: {},
|
|
355
|
+
terminals: {},
|
|
356
|
+
fileRevisions: {},
|
|
357
|
+
approvals: {},
|
|
358
|
+
managedWrites: {},
|
|
359
|
+
workspaceDependencies: {},
|
|
360
|
+
executionGroup: { stopConfirmed: false, replaced: false },
|
|
361
|
+
lastSourceSequence: 0,
|
|
362
|
+
acceptedLeaseFence: 0,
|
|
363
|
+
destroyed: false,
|
|
364
|
+
};
|
|
365
|
+
}
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
import { operationRecordSchema } from '@playcraft/common/cloud-workspace/runtime';
|
|
2
|
+
/** Native ancestry is durable platform metadata, never inferred from an arbitrary turn identifier. */
|
|
3
|
+
export function nativeEventOwner(database, threadId, turnId) {
|
|
4
|
+
if (!threadId)
|
|
5
|
+
return undefined;
|
|
6
|
+
const direct = sessionsForThread(database, threadId);
|
|
7
|
+
if (direct.length) {
|
|
8
|
+
if (direct.length !== 1)
|
|
9
|
+
return undefined;
|
|
10
|
+
const session = direct[0];
|
|
11
|
+
const operation = readOperation(database, 'turn_id', turnId ?? text(session.activeTurnId), threadId);
|
|
12
|
+
if (turnId && !ownsOperation(session, threadId, operation))
|
|
13
|
+
return undefined;
|
|
14
|
+
return { session, operation: ownsOperation(session, threadId, operation) ? operation : undefined };
|
|
15
|
+
}
|
|
16
|
+
const link = readRecord(database, 'native_subagent_threads', threadId);
|
|
17
|
+
if (!link || link.operationConfirmed === false)
|
|
18
|
+
return undefined;
|
|
19
|
+
const roots = sessionsForThread(database, link.rootThreadId);
|
|
20
|
+
if (roots.length !== 1)
|
|
21
|
+
return undefined;
|
|
22
|
+
const session = roots[0];
|
|
23
|
+
if (session.sessionId !== link.sessionId || session.workspaceId !== link.workspaceId)
|
|
24
|
+
return undefined;
|
|
25
|
+
const turnKey = turnId ? JSON.stringify([threadId, turnId]) : undefined;
|
|
26
|
+
const pinned = turnKey ? readRecord(database, 'native_subagent_turns', turnKey) : undefined;
|
|
27
|
+
const pending = turnKey && !pinned ? readRecord(database, 'native_subagent_pending_followups', threadId) : undefined;
|
|
28
|
+
if (pending) {
|
|
29
|
+
const followup = readOperation(database, 'scope_key', text(pending.operationScopeKey));
|
|
30
|
+
if (followup?.operation.status === 'accepted' && followup.operation.nativeTurnId === session.activeTurnId)
|
|
31
|
+
return undefined;
|
|
32
|
+
database.prepare('DELETE FROM records WHERE bucket = ? AND record_key = ?').run('native_subagent_pending_followups', threadId);
|
|
33
|
+
}
|
|
34
|
+
const scopeKey = text(pinned?.operationScopeKey) ?? link.operationScopeKey;
|
|
35
|
+
const operation = scopeKey
|
|
36
|
+
? readOperation(database, 'scope_key', scopeKey)
|
|
37
|
+
: readOperation(database, 'turn_id', text(session.activeTurnId), link.rootThreadId);
|
|
38
|
+
if (!ownsOperation(session, link.rootThreadId, operation))
|
|
39
|
+
return undefined;
|
|
40
|
+
if (turnKey && !pinned)
|
|
41
|
+
writeRecord(database, 'native_subagent_turns', turnKey, { operationScopeKey: operation.scopeKey });
|
|
42
|
+
const { sessionId: _, workspaceId: __, operationScopeKey: ___, operationConfirmed: ____, ...subAgent } = link;
|
|
43
|
+
return { session, operation, subAgent };
|
|
44
|
+
}
|
|
45
|
+
/** Only native thread ancestry or a spawn from an already owned thread can introduce a child. */
|
|
46
|
+
export function learnNativeSubagents(database, method, params, threadId, turnId) {
|
|
47
|
+
const payload = record(params);
|
|
48
|
+
if (method === 'thread/started') {
|
|
49
|
+
const thread = record(payload.thread);
|
|
50
|
+
const spawn = record(record(record(thread.source).subAgent).thread_spawn);
|
|
51
|
+
const childId = text(thread.id);
|
|
52
|
+
const parentId = text(thread.parentThreadId) ?? text(spawn.parent_thread_id);
|
|
53
|
+
if (!childId || !parentId || (text(thread.parentThreadId) && text(spawn.parent_thread_id) && thread.parentThreadId !== spawn.parent_thread_id))
|
|
54
|
+
return [];
|
|
55
|
+
const owner = nativeEventOwner(database, parentId);
|
|
56
|
+
if (!owner)
|
|
57
|
+
return [];
|
|
58
|
+
const changed = remember(database, childId, parentId, owner, {
|
|
59
|
+
agentNickname: text(thread.agentNickname) ?? text(spawn.agent_nickname),
|
|
60
|
+
agentRole: text(thread.agentRole) ?? text(spawn.agent_role),
|
|
61
|
+
agentPath: text(spawn.agent_path),
|
|
62
|
+
}, false);
|
|
63
|
+
return changed ? [childId] : [];
|
|
64
|
+
}
|
|
65
|
+
if (method !== 'item/started' && method !== 'item/completed')
|
|
66
|
+
return [];
|
|
67
|
+
const item = record(payload.item);
|
|
68
|
+
if (item.type !== 'collabAgentToolCall' || item.senderThreadId !== threadId)
|
|
69
|
+
return [];
|
|
70
|
+
const owner = nativeEventOwner(database, threadId, turnId);
|
|
71
|
+
if (!owner || !owner.operation)
|
|
72
|
+
return [];
|
|
73
|
+
const receivers = Array.isArray(item.receiverThreadIds) ? item.receiverThreadIds.filter((id) => typeof id === 'string' && id.length > 0) : [];
|
|
74
|
+
const changed = [];
|
|
75
|
+
for (const childId of receivers) {
|
|
76
|
+
if (item.tool === 'spawnAgent') {
|
|
77
|
+
if (remember(database, childId, threadId, owner, {}))
|
|
78
|
+
changed.push(childId);
|
|
79
|
+
}
|
|
80
|
+
else if (['sendInput', 'resumeAgent', 'sendMessage', 'followupTask'].includes(String(item.tool))) {
|
|
81
|
+
const existing = readRecord(database, 'native_subagent_threads', childId);
|
|
82
|
+
if (!existing || existing.sessionId !== owner.session.sessionId || existing.rootThreadId !== (owner.subAgent?.rootThreadId ?? threadId))
|
|
83
|
+
continue;
|
|
84
|
+
if (method === 'item/started' && item.status === 'inProgress' && existing.operationScopeKey !== owner.operation.scopeKey) {
|
|
85
|
+
writeRecord(database, 'native_subagent_pending_followups', childId, { itemId: item.id, operationScopeKey: owner.operation.scopeKey });
|
|
86
|
+
continue;
|
|
87
|
+
}
|
|
88
|
+
if (method !== 'item/completed')
|
|
89
|
+
continue;
|
|
90
|
+
const pending = readRecord(database, 'native_subagent_pending_followups', childId);
|
|
91
|
+
if (pending?.itemId === item.id)
|
|
92
|
+
database.prepare('DELETE FROM records WHERE bucket = ? AND record_key = ?').run('native_subagent_pending_followups', childId);
|
|
93
|
+
if (item.status === 'completed' && existing.operationScopeKey !== owner.operation.scopeKey)
|
|
94
|
+
writeRecord(database, 'native_subagent_threads', childId, { ...existing, operationScopeKey: owner.operation.scopeKey });
|
|
95
|
+
if (pending?.itemId === item.id || item.status === 'completed')
|
|
96
|
+
changed.push(childId);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
return changed;
|
|
100
|
+
}
|
|
101
|
+
export function nativeSubagentThreads(database, rootThreadId) {
|
|
102
|
+
const rows = database.prepare("SELECT record_key FROM records WHERE bucket = 'native_subagent_threads' AND json_extract(body_json, '$.rootThreadId') = ?")
|
|
103
|
+
.all(rootThreadId);
|
|
104
|
+
return rows.map(row => row.record_key);
|
|
105
|
+
}
|
|
106
|
+
export function clearPendingNativeFollowups(database) {
|
|
107
|
+
const rows = database.prepare("SELECT record_key FROM records WHERE bucket = 'native_subagent_pending_followups'")
|
|
108
|
+
.all();
|
|
109
|
+
database.prepare("DELETE FROM records WHERE bucket = 'native_subagent_pending_followups'").run();
|
|
110
|
+
return rows.map(row => row.record_key);
|
|
111
|
+
}
|
|
112
|
+
function remember(database, childId, parentId, owner, metadata, confirmed = true) {
|
|
113
|
+
if (childId === parentId || sessionsForThread(database, childId).length)
|
|
114
|
+
return false;
|
|
115
|
+
const rootThreadId = owner.subAgent?.rootThreadId ?? text(owner.session.threadId);
|
|
116
|
+
if (childId === rootThreadId)
|
|
117
|
+
return false;
|
|
118
|
+
const previous = readRecord(database, 'native_subagent_threads', childId);
|
|
119
|
+
if (previous && (previous.parentThreadId !== parentId || previous.rootThreadId !== rootThreadId || previous.sessionId !== owner.session.sessionId))
|
|
120
|
+
return false;
|
|
121
|
+
const defined = Object.fromEntries(Object.entries(metadata).filter(([, value]) => value !== undefined));
|
|
122
|
+
// Thread ancestry contains no parent turn. Wait for its spawn item before archiving events
|
|
123
|
+
// against an operation: a parent agent may still be running an older, pinned turn.
|
|
124
|
+
const wasConfirmed = previous && previous.operationConfirmed !== false;
|
|
125
|
+
const next = { ...previous, ...defined, threadId: childId, parentThreadId: parentId, rootThreadId,
|
|
126
|
+
sessionId: String(owner.session.sessionId), workspaceId: text(owner.session.workspaceId),
|
|
127
|
+
operationConfirmed: Boolean(wasConfirmed || confirmed),
|
|
128
|
+
operationScopeKey: wasConfirmed ? previous.operationScopeKey : confirmed ? owner.operation?.scopeKey : undefined };
|
|
129
|
+
if (JSON.stringify(previous) === JSON.stringify(next))
|
|
130
|
+
return false;
|
|
131
|
+
writeRecord(database, 'native_subagent_threads', childId, next);
|
|
132
|
+
return true;
|
|
133
|
+
}
|
|
134
|
+
function ownsOperation(session, rootThreadId, found) {
|
|
135
|
+
return Boolean(found && ['session.turn', 'session.review', 'session.compact'].includes(found.operation.kind) && found.operation.sessionId === session.sessionId &&
|
|
136
|
+
(found.operation.workspaceId === undefined || found.operation.workspaceId === session.workspaceId) && found.operation.nativeThreadId === rootThreadId);
|
|
137
|
+
}
|
|
138
|
+
function readOperation(database, column, value, threadId) {
|
|
139
|
+
if (!value)
|
|
140
|
+
return undefined;
|
|
141
|
+
const row = database.prepare(`SELECT scope_key, operation_json FROM operation_intents WHERE ${column} = ?${threadId ? ' AND thread_id = ?' : ''}${column === 'turn_id' ? " AND json_extract(operation_json, '$.kind') IN ('session.turn', 'session.review', 'session.compact')" : ''}`)
|
|
142
|
+
.get(...(threadId ? [value, threadId] : [value]));
|
|
143
|
+
if (!row)
|
|
144
|
+
return undefined;
|
|
145
|
+
const parsed = operationRecordSchema.safeParse(JSON.parse(row.operation_json));
|
|
146
|
+
return parsed.success ? { scopeKey: row.scope_key, operation: parsed.data } : undefined;
|
|
147
|
+
}
|
|
148
|
+
function sessionsForThread(database, threadId) {
|
|
149
|
+
const rows = database.prepare("SELECT body_json FROM records WHERE bucket = 'sessions' AND json_extract(body_json, '$.threadId') = ?")
|
|
150
|
+
.all(threadId);
|
|
151
|
+
return rows.map(row => record(JSON.parse(row.body_json)));
|
|
152
|
+
}
|
|
153
|
+
function readRecord(database, bucket, key) {
|
|
154
|
+
const row = database.prepare('SELECT body_json FROM records WHERE bucket = ? AND record_key = ?').get(bucket, key);
|
|
155
|
+
return row ? record(JSON.parse(row.body_json)) : undefined;
|
|
156
|
+
}
|
|
157
|
+
function writeRecord(database, bucket, key, value) {
|
|
158
|
+
database.prepare('INSERT INTO records (bucket, record_key, body_json) VALUES (?, ?, ?) ON CONFLICT(bucket, record_key) DO UPDATE SET body_json = excluded.body_json')
|
|
159
|
+
.run(bucket, key, JSON.stringify(value));
|
|
160
|
+
}
|
|
161
|
+
function text(value) { return typeof value === 'string' && value.length > 0 ? value : undefined; }
|
|
162
|
+
function record(value) { return value && typeof value === 'object' && !Array.isArray(value) ? value : {}; }
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { existsSync } from 'node:fs';
|
|
2
|
+
import { fileURLToPath } from 'node:url';
|
|
3
|
+
import { Worker } from 'node:worker_threads';
|
|
4
|
+
export class SqliteWorkerClient {
|
|
5
|
+
nextId = 1;
|
|
6
|
+
pending = new Map();
|
|
7
|
+
chain = Promise.resolve();
|
|
8
|
+
worker;
|
|
9
|
+
constructor(worker) {
|
|
10
|
+
this.worker = worker;
|
|
11
|
+
worker.on('message', (message) => {
|
|
12
|
+
const waiter = this.pending.get(message.id);
|
|
13
|
+
if (!waiter)
|
|
14
|
+
return;
|
|
15
|
+
this.pending.delete(message.id);
|
|
16
|
+
if (message.ok)
|
|
17
|
+
waiter.resolve(message.result);
|
|
18
|
+
else
|
|
19
|
+
waiter.reject(new Error(message.error || 'sqlite_worker_failed'));
|
|
20
|
+
});
|
|
21
|
+
worker.on('error', (error) => {
|
|
22
|
+
for (const waiter of this.pending.values())
|
|
23
|
+
waiter.reject(error);
|
|
24
|
+
this.pending.clear();
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
static async open(filePath, legacy) {
|
|
28
|
+
const url = workerUrl();
|
|
29
|
+
const execArgv = url.pathname.endsWith('.ts') ? ['--import', sourceResolver()] : [];
|
|
30
|
+
const client = new SqliteWorkerClient(new Worker(url, { execArgv, env: { ...process.env, NODE_OPTIONS: '' } }));
|
|
31
|
+
try {
|
|
32
|
+
const opened = await client.request('open', { filePath, legacy });
|
|
33
|
+
return { client, opened };
|
|
34
|
+
}
|
|
35
|
+
catch (error) {
|
|
36
|
+
await client.close().catch(() => undefined);
|
|
37
|
+
throw error;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
request(type, payload) {
|
|
41
|
+
const run = this.chain.then(() => this.send(type, payload));
|
|
42
|
+
this.chain = run.then(() => undefined, () => undefined);
|
|
43
|
+
return run;
|
|
44
|
+
}
|
|
45
|
+
async close() {
|
|
46
|
+
await this.request('close', {}).catch(() => undefined);
|
|
47
|
+
await this.worker.terminate();
|
|
48
|
+
}
|
|
49
|
+
send(type, payload) {
|
|
50
|
+
const id = this.nextId;
|
|
51
|
+
this.nextId += 1;
|
|
52
|
+
return new Promise((resolve, reject) => {
|
|
53
|
+
this.pending.set(id, { resolve: (value) => resolve(value), reject });
|
|
54
|
+
this.worker.postMessage({ id, type, payload });
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
function workerUrl() {
|
|
59
|
+
const compiled = new URL('./sqlite-worker.js', import.meta.url);
|
|
60
|
+
if (existsSync(fileURLToPath(compiled)))
|
|
61
|
+
return compiled;
|
|
62
|
+
return new URL('./sqlite-worker.ts', import.meta.url);
|
|
63
|
+
}
|
|
64
|
+
/** Source tests use Node's type stripping, with relative emitted imports resolved to their sources. */
|
|
65
|
+
function sourceResolver() {
|
|
66
|
+
return `data:text/javascript,${encodeURIComponent(`
|
|
67
|
+
import { registerHooks } from 'node:module';
|
|
68
|
+
import { existsSync } from 'node:fs';
|
|
69
|
+
registerHooks({ resolve(specifier, context, next) {
|
|
70
|
+
if (context.parentURL?.endsWith('.ts') && specifier.startsWith('./') && specifier.endsWith('.js')) {
|
|
71
|
+
const source = new URL(specifier.slice(0, -3) + '.ts', context.parentURL);
|
|
72
|
+
if (existsSync(source)) return next(source.href, context);
|
|
73
|
+
}
|
|
74
|
+
return next(specifier, context);
|
|
75
|
+
} });
|
|
76
|
+
`)}`;
|
|
77
|
+
}
|