fix(cli): stop uipath init on an unscaffolded Studio Web project

[vldcmp-uipath]

Problem

Studio Web's cloud-workspace flow hands you a folder containing only project.uiproj. Running uipath init there wrote .env, uipath.json, bindings.json and entry-points.json, then crashed with an unhandled FileNotFoundError on the missing pyproject.toml. The project was left half-initialised, with empty functions/agents maps and no source file.

Fix

init now checks for that state before writing anything. When project.uiproj is the only visible entry in the directory, it exits with an actionable message instead:

❌ This project has not been scaffolded yet: 'project.uiproj' is the only file in this directory.
Scaffold it first by running:
`uipath new function`

• The suggested name is read from project.uiproj → Name and normalized to a valid PEP 508 project name (lowercased, invalid runs collapsed to -). Falls back to uipath new <name> when no name is available.
• Hidden entries (.uipath, .git, .env, ...) are ignored when deciding whether the directory is still the bare template.
• The check is language-agnostic: it does not look for pyproject.toml, so the same template folder can still become a JS project.
• No files are written on failure.

Tests

Added to tests/cli/test_init.py:

• guard triggers with a name and leaves the directory untouched
• placeholder fallback when Name is missing
• hidden entries do not mask the template state
• project.uiproj alongside real sources still initializes normally

Version

uipath 2.14.22 → 2.14.23

🤖 Generated with Claude Code

[Copilot]

🟡 Changes recommended

Handle valid project.uiproj JSON whose root is not an object to avoid an unhandled exception.

Get a fresh assessment by requesting another Copilot review.

Pull request overview

Updates uipath init to detect unscaffolded Studio Web projects without writing files, adds regression tests, and bumps the version to 2.14.23.

Changes:

• Detects bare project.uiproj directories and suggests uipath new.
• Normalizes project names and ignores hidden entries.
• Adds initialization guard tests.
• Updates package and lockfile versions.

File summaries

File	Summary
packages/uipath/uv.lock	Synchronizes the locked package version.
packages/uipath/tests/cli/test_init.py	Adds tests for the initialization guard.
packages/uipath/src/uipath/_cli/cli_init.py	Adds scaffold detection and project-name normalization.
packages/uipath/pyproject.toml	Updates the package version.

Review details

• Files reviewed: 3/4 changed files
• Comments generated: 1
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[andreiancuta-uipath]

I didn't know sets have this operator and had too look it up. I find visible_entries.issubset({UIPROJ_FILE}) easier to understand, but it's still not immediately clear what we're checking.

I would make the cases explicit in the next if, since it checks for empty vs singleton set anyway:

if not visible_entries:
    reason = "this directory is empty."
elif visible_entries == {UIPROJ_FILE}:
    ...
else:
    return

[vldcmp-uipath]

indeed, i have changed it

[github-actions]

🚨 Heads up: uipath-langchain cross-tests are FAILING 🚨

Your changes may break the uipath-langchain-python integration.

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud