Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 20 additions & 17 deletions skills/uipath-activity-migrator/SKILL.md

Large diffs are not rendered by default.

124 changes: 90 additions & 34 deletions skills/uipath-activity-migrator/references/acquisition-guide.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

> **Owner review pending.** Pre-filled from the migrator source (`UiPath.Upgrade.GSuiteActivities`). Lines marked `VERIFY` need confirmation by the GSuite package owners. Extend the three hooks; keep their headings.

Extension `GSuiteActivities`. The public build lists its flags and runs its migrators (verified on 25.10.1; its preview gate is compiled in unconditionally). Still confirm with `"<MIGRATOR_EXE>" analyze --help`: a build that lists no `--gsuite-*` flag has no GSuite extension; report classic GSuite activities as not migrated and skip the rest of this guide.
Extension `GSuiteActivities`. The public build lists its flags and runs its migrators (verified on 25.10.1; its preview gate is compiled in unconditionally). Still confirm with `<MIGRATOR> analyze --help`: a build that lists no `--gsuite-*` flag has no GSuite extension; report classic GSuite activities as not migrated and skip the rest of this guide.

Applies when `project.json` lists `UiPath.GSuite.Activities`; the version alone does not decide it (a `3.5.10` project still carries classic activities, which the tool migrates while raising the package to its `3.8.10` minimum or the requested version). Do not pre-scan the XAML: the `analyze` run reports every affected activity per file.

Expand All @@ -16,7 +16,7 @@ Applies when `project.json` lists `UiPath.GSuite.Activities`; the version alone

### Flags

Availability and defaults come from `"<MIGRATOR_EXE>" analyze --help` on the installed build (Step 0).
Availability and defaults come from `<MIGRATOR> analyze --help` on the installed build (Step 0).

| Flag | Use |
|---|---|
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Extension `MailActivities`. Applies when `project.json` lists `UiPath.Mail.Activ

### Flags

Availability and defaults come from `"<MIGRATOR_EXE>" analyze --help` on the installed build (Step 0).
Availability and defaults come from `<MIGRATOR> analyze --help` on the installed build (Step 0).

| Flag | Use |
|---|---|
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ The migration logic is not in the CLI. The extension loads the migration service

### Flags

Availability and defaults come from `"<MIGRATOR_EXE>" analyze --help` on the installed build (Step 0). This table says what each flag does and when to use it. Other `--uia-*` flags may exist in a newer build; Step 0 says when an unlisted flag may be used.
Availability and defaults come from `<MIGRATOR> analyze --help` on the installed build (Step 0). This table says what each flag does and when to use it. Other `--uia-*` flags may exist in a newer build; Step 0 says when an unlisted flag may be used.

| Flag | Use |
|---|---|
Expand Down
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Tool Behavior Guide

Facts about `UiPath.Upgrade.exe` that neither `--help` nor the product documentation states, learned from the tool's source and from live runs. For the list of commands and flags, the installed build is the only authority:
Facts about the Activity Migrator that neither `--help` nor the product documentation states, learned from the tool's source and from live runs. They hold for both forms of `<MIGRATOR>` (Step 0): `uip rpa project migrate`, which runs the migrator inside Helm and hands it its arguments, stdout, stderr and exit code unchanged, and the standalone `UiPath.Upgrade.exe`. For the list of commands and flags, the installed build is the only authority:

```bash
"<MIGRATOR_EXE>" analyze --help
<MIGRATOR> analyze --help
```

Core options come first, then one block per active extension. A flag named anywhere in this skill but missing from that output does not exist in this build: do not pass it, and say so in the report.
Expand All @@ -15,7 +15,7 @@ Core options come first, then one block per active extension. A flag named anywh

## Exit code

`0` for success, partial success, and failure alike: every exception inside a step, a crashed core step included, is caught and written into the SARIF as a result (rule `ERROR` or `WARNING`, message `Step failed: <Step> - <exception>`), and the log is still printed. Non-zero only when the command never ran, a rejected command line or a startup crash; then stdout holds no log and the one-line cause is on stderr. Status comes from the SARIF results (see [sarif-triage-guide.md](sarif-triage-guide.md)).
`0` for success, partial success, and failure alike: every exception inside a step, a crashed core step included, is caught and written into the SARIF as a result (rule `ERROR` or `WARNING`, message `Step failed: <Step> - <exception>`), and the log is still printed. Non-zero only when the command never ran, a rejected command line or a startup crash; then stdout holds no log and the one-line cause is on stderr. Through `uip`, a failure of `uip` itself (Helm not found) also exits 1, with a JSON object holding `"Result":"Failure"` on stdout or stderr. Status comes from the SARIF results (see [sarif-triage-guide.md](sarif-triage-guide.md)).

## Output streams

Expand Down Expand Up @@ -45,7 +45,7 @@ Created inside the source project on every run, `analyze` included. Files per ru
Secrets never pass through the agent (Critical Rule 6). Hand the user the complete command with placeholders:

```bash
"<MIGRATOR_EXE>" analyze --project-path "<PROJECT_DIR>" --output-format sarif --orchestrator-url "https://cloud.uipath.com/<ORG>" --orchestrator-tenant "<TENANT>" --orchestrator-pat "<PAT>" > "<PROJECT_DIR>/.upgrade/analyze-latest.sarif"
<MIGRATOR> analyze --project-path "<PROJECT_DIR>" --output-format sarif --orchestrator-url "https://cloud.uipath.com/<ORG>" --orchestrator-tenant "<TENANT>" --orchestrator-pat "<PAT>" > "<PROJECT_DIR>/.upgrade/analyze-latest.sarif"
```

## Extensions
Expand All @@ -57,7 +57,7 @@ Secrets never pass through the agent (Critical Rule 6). Hand the user the comple
## bulk

```bash
"<MIGRATOR_EXE>" bulk --path "<ROOT>" --command analyze
<MIGRATOR> bulk --path "<ROOT>" --command analyze
node "<SKILL_DIR>/scripts/summarize-sarif.mjs" "<ROOT>/repository-analyze-results.sarif"
```

Expand Down
Loading
Loading