Avora

VS Code extension to locally test generated Avora projects.

What It Supports

• Login with your Avora account
• See your project list (workspaces)
• Pull a project codebase locally
• Update a previously pulled project when frontend/workspace changes
• Run a project directly from the project list click
• Activity Bar entry with a left sidebar project list
• Sidebar login-first state with a primary Login to Start button
• Visual status bar buttons for Connect/User, Current Project, Run, Pull, Update, and Backend
• One-click backend URL input to switch away from localhost
• Keep pulled code read-only for now (editing flow intentionally disabled)

Commands

• Avora: Login
• Avora: Logout
• Avora: Account Actions
• Avora: Set Backend URL
• Avora: Open Settings
• Avora: Open Page
• Avora: List Projects
• Avora: Select Current Project
• Avora: Project Actions
• Avora: Run Project
• Avora: Refresh Projects
• Avora: Pull Project Code
• Avora: Update Pulled Project
• Avora: Update Current Project
• Avora: Editing is Disabled

Activity Bar + Sidebar

• Click the Avora icon in the Activity Bar to open the Avora sidebar.
• If not logged in, the sidebar shows Login to Start.
• If logged in, the sidebar shows:
  • Projects
  • My Published Logic Nodes
• Click a project to run it directly.
• Use right-click/inline actions for pull/update/open folder actions.
• Update appears only for projects that were already pulled locally.
• Sidebar header has a single refresh action.

Status Bar Actions

The extension adds a bottom status bar action strip:

• Connect or User (account menu: connect/disconnect/refresh)
• Current Project (shows selected/open project; click to switch/open another pulled project)
• Run (runs the current selected/open project)
• Pull
• Update (one-click update for the current selected/open pulled project)
• Backend (quick input to configure API base URL)

Local Pull Workflow

1. Login from Command Palette.
2. Run Avora: List Projects and choose a project.
3. Pull code.
4. Extension fetches:
   • workspace graph from /api/v1/workspaces/{id}/graph
   • generated ZIP from /api/v1/generator/download
5. Code is written to:
   • avora-projects/<project-name> in current workspace by default
   • or avora.defaultPullRoot/<project-name> if configured

Update Workflow

• Run Avora: Update Pulled Project.
• Or click status bar Update to update the current selected/open project in one click.
• Extension compares hashes/manifests.
• If changed, it snapshots existing code then applies update.
• Local runtime folders (like venv, .venv, node_modules) are preserved during updates.
• If dependency manifests change (requirements.txt, pyproject.toml, lockfiles), extension warns that dependencies should be reinstalled.

Read-Only Behavior (Editing Disabled)

• Pulled files are marked read-only (enabled by default).
• Extension unlocks files only during managed updates, then locks them again.
• This is controlled by avora.readOnlyPulledCode.

Failure Handling and Recovery

The extension is designed to avoid destructive updates:

• If export/generation fails, local code is left unchanged.
• Before overwrite, a snapshot is created under:
  • <project>/.avora/snapshots/<timestamp>
• If update fails during write, extension restores from the latest snapshot.
• Sync metadata is saved at:
  • <project>/.avora/pull-meta.json

This covers cases where:

• a project cannot export code
• local files changed unexpectedly
• a previously correct pulled project needs safe updating

Settings

• avora.apiBaseUrl (default: http://localhost:8000/api/v1)
• avora.defaultPullRoot (default: empty)
• avora.readOnlyPulledCode (default: true)
• avora.preserveLocalRuntimeFolders (default: [], merged with built-in preserved folders)