Skip to content

calm workspace commands#2378

Draft
willosborne wants to merge 48 commits into
finos:mainfrom
willosborne:calm-workspace-commands
Draft

calm workspace commands#2378
willosborne wants to merge 48 commits into
finos:mainfrom
willosborne:calm-workspace-commands

Conversation

@willosborne
Copy link
Copy Markdown
Member

@willosborne willosborne commented Apr 24, 2026

Description

Adds initial calm workspace features.
Purpose of this is to provide a local editing workflow similar to git branches - a workspace with files that will be resolved locally when validating, etc.
It allows pulling and pushing of files in these workspaces to/from CalmHub.

Commands (all under calm workspace xyz):

  • init - makes a new workspace in root of current repository.
  • add - tracks a file in the workspace.
  • populate - finds all referenced files from currently-tracked files and adds them to the workspace
  • push - upload tracked files to calmhub. will bump versions if it exists already. (TODO: bump versions in tracked files)
  • switch - change workspace
  • tree - print contents of current workspace in a tree-like format
  • clean - delete contents of current workspace or even entire workspace folder with --all

See cli/README.md for more details.

Also contains small documentation update to CalmHub's FrontControllerResource, which this tool depends on.

TODOs:

  • pull - downloads tracked files from calmhub (TODO: make this pull the latest version and update tracked files to reflect new version number)
  • populate currently also pulls in the core schemas - this may not always be intended
  • calmhub loses the names in the tree view after first push

Type of Change

  • 🐛 Bug fix (non-breaking change which fixes an issue)
  • ✨ New feature (non-breaking change which adds functionality)
  • 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • 📚 Documentation update
  • 🎨 Code style/formatting changes
  • ♻️ Refactoring (no functional changes)
  • ⚡ Performance improvements
  • ✅ Test additions or updates
  • 🔧 Chore (maintenance, dependencies, CI, etc.)

Affected Components

  • CLI (cli/)
  • Schema (calm/)
  • CALM AI (calm-ai/)
  • CALM Hub (calm-hub/)
  • CALM Hub UI (calm-hub-ui/)
  • CALM Server (calm-server/)
  • CALM Widgets (calm-widgets/)
  • Documentation (docs/)
  • Shared (shared/)
  • VS Code Extension (calm-plugins/vscode/)
  • Dependencies
  • CI/CD

Commit Message Format ✅

Testing

  • I have tested my changes locally
  • I have added/updated unit tests
  • All existing tests pass

Checklist

  • My commits follow the conventional commit format
  • I have updated documentation if necessary
  • I have added tests for my changes (if applicable)
  • My changes follow the project's coding standards

willosborne and others added 30 commits February 5, 2026 14:32
@github-actions github-actions Bot added cli Affects `cli` code calm-hub Affects `calm-hub` shared config calm-hub-ui Affects `calm-hub-ui` labels Apr 24, 2026
@willosborne willosborne marked this pull request as draft April 24, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

calm-hub Affects `calm-hub` calm-hub-ui Affects `calm-hub-ui` cli Affects `cli` code config shared

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants