Conflu — Thingworx Source Management (VS Code / Cursor extension)

Thin UI layer over the conflu CLI. Provides file-level compare between projects/ (local source) and live ThingWorx via native Monaco vscode.diff, plus entity-directory compare and canonical Project-folder operations.

Install the CLI first:

npm i -g @xudesheng/conflu

Commands

• Conflu: Compare with environment… — right-click any file under projects/<EncodedProjectName>/<EntityTypePlural>/<EncodedName>/... → pick env → the extension spawns conflu cache fetch -e <env> --from-repo-path <path> --format json to pull that entity into .conflu/cache/<env>/, then opens vscode.diff(local, cache).
• Conflu: Open cache folder for environment… — add .conflu/cache/<env>/ as a workspace folder for browsing the most recently fetched entities.
• Conflu: Compare entity with environment… — right-click a composite Entity directory, choose an environment, and select a changed/local-only/remote-only file from the CLI-produced inventory to open the corresponding native diff.
• Conflu: Validate project — validate the selected canonical Project tree.
• Conflu: List entities — list entities from the selected Project.
• Conflu: Export project… — choose XML or TWX and save one artifact.
• Conflu: Pull project from environment… — choose an environment and wire format, confirm replacement of the entire selected tree, then perform the clean directory-form pull.

Conflu: Refresh cache for environment… is not contributed at MVP — the CLI conflu cache refresh currently exits 2 with a "not implemented" message, and the extension deliberately does not expose a command that would only surface that error. The refresh command will return once the full local-driven refresh body lands.

See the main conflu repository for the full contract (docs/core/compare.md and docs/core/vscode-extension.md).

Versioning

This extension’s package.json version is aligned with the Rust workspace release version (same repository Cargo.toml) when publishing from this monorepo.

Development

cd vscode-extension
npm install
npm run build      # esbuild → dist/extension.js
npm run package    # vsce package → conflu-<version>.vsix

The documented npm run package command must succeed without extra manual vsce flags — if it does not, that is a packaging bug to fix.

Needs conflu on PATH when the extension runs. The recommended install path is:

npm i -g @xudesheng/conflu

Compatibility

• VS Code 1.85+
• Cursor (VS Code fork, same Extension API)

Version coupling

The extension's package.json#version tracks the conflu CLI's workspace Cargo.toml version (same release tag). package.json#conflu.minCliSchemaVersion declares the minimum --format json schema version this build understands.