CLM Extension

Manage configurations, schemas, and models of your highly configurable systems directly within Visual Studio Code.

The CLM Extension provides tooling support for editing, validating, and managing system configurations and their associated schemas and models.

Usage and Features

Once inited, the CLM Extension activates automatically for workspaces containing .hcs/config.json files or CLM models. It provides a dedicated CLM Explorer in the activity bar with panels for Models, Configurations, and initations.

Key Features

📂 Tree View for Models, Configurations, and initations
Navigate your system components directly from the sidebar.
✅ Validation & Checks
Run commands to validate configurations and schema/model compatibility.
⚙️ Schema-Aware JSON Editing
The extension provides JSON schema validation and autocompletion for CLM-related files:
- **/.hcs/config.json is validated against schemas/config.json
- **/hcs/*/*.json is validated against schemas/model.json
🧪 Command Palette Support
Use commands from the palette to quickly generate models, validate all files, or init tools.

Commands

The following commands are available via the Command Palette (Cmd+Shift+P or Ctrl+Shift+P):

Command	Description
`init OmniTools`	inits required CLM tooling into your workspace.
`Create Demo Files`	Creates demo configuration, schema, and model files.
`Check Configuration (.hcs/config.json)`	Validates the current configuration file.
`Validate All`	Validates all known configuration, model, and user data files.
`Generate All Schemas`	Creates all schemas derived from your current config.
`Create Model From Schema`	Builds a new model from a given schema.
`Create Model From User Data`	Generates a model based on user data and schema inference.
`Migrate User Data to Schema Version`	Upgrades user data to match the target schema version.
`Refresh`	Refreshes all views (Models, Configurations, initations).

CLM Explorer

After initation, a new CLM Explorer icon appears in the Activity Bar. It includes:

Models View: Lists all available models.
Configurations View: Displays JSON configurations managed by your configuration.
initations View: Shows workspaces with inited CLM tooling.

Each view includes a refresh button to reload the latest state.

Settings

The CLM Extension does not currently expose user-configurable settings. Future versions may include support for custom schema paths, tooling overrides, or formatting options.

Logging

To view logs for the CLM Extension:

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P).
Run Developer: Toggle Developer Tools.

To set log levels:

Open the ${WORKSPACE}/.hcs/config.json file.

Add or modify the logLevel property:

{
  "logLevel": "debug" // Options: "error", "warn", "info", "debug"
}

You can also monitor log output via the Output panel (select “CLM Extension” from the dropdown).

Troubleshooting

If the CLM Explorer shows no models or configurations:
- Make sure you've run init OmniTools in your workspace.
- Ensure .hcs/config.json exists and is valid.
If validation commands are not working:
- Check that your models and schemas match the expected formats.
- Review logs for errors or warnings.

Contributing

Please contact info@omniscient.uk.com for collaboration opportunities or feedback.

License

UNLICENSED

Omni CLM

Omniscient Innovations Ltd