migrate-to-projects

Migrate to Projects

Your human (or a previous session) edited files in /workspace/woltspace/ — the platform code. This causes problems: when the platform updates, those changes get overwritten or cause merge conflicts. Your job is to safely extract their work into wolt/apps/ and restore the platform to a clean state.

Be careful. This is a recovery operation. Don't lose anyone's work.

Step 1: Assess the damage

Check what's been modified in the platform directory:

cd /workspace/woltspace
git status
git diff --stat

Categorize the changes:

• User code — new files, new features, apps they built (these need to be saved)
• Config tweaks — changes to server.js, entrypoint, bot code (these need to be understood, then discarded)
• Untracked files — new files that aren't part of the platform (likely user work)

Tell the human what you found. Be specific: "You have 3 modified files and 5 new files in the platform directory. Here's what I see..."

Step 2: Extract user work

For each piece of user work you find:

1. Create an app directory: mkdir -p wolt/apps/{name}
2. Copy the files there: cp -r /workspace/woltspace/{path} wolt/apps/{name}/
3. If it's an app that was running on a port, note the port in woltspace.json
4. If it depends on platform code (imports from server.js, etc.), refactor those dependencies out — the app should be self-contained

Example extractions:

• Custom API endpoint added to server.js → extract into its own FastAPI/Express server in an app
• Modified bot behavior → document what they wanted in a memory file, suggest filing an issue
• New HTML pages in public/ → move to wolt/site/ or an app
• New scripts in container/bin/ → move to an app

Step 3: Document config changes

Some changes are config tweaks rather than new code. For these:

• Note what was changed and why (ask the human if unclear)
• Check if there's a proper way to achieve the same thing (env vars, wolt-specific overrides, skill customization)
• If it's a legitimate feature request, suggest filing an issue on the woltspace repo