@uipath/skills 1.199.0 → 1.200.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/CODEOWNERS +14 -8
- package/README.md +18 -3
- package/assets/skill-status.json +9 -1
- package/assets/uip-catalog-snapshot.json +227 -21
- package/package.json +11 -2
- package/scripts/npm-package-lifecycle.mjs +46 -0
- package/skills/uipath-admin/SKILL.md +5 -1
- package/skills/uipath-admin/references/audit-commands.md +1 -1
- package/skills/uipath-admin/references/audit-workflow-guide.md +9 -0
- package/skills/uipath-agents/SKILL.md +2 -2
- package/skills/uipath-agents/references/lowcode/capabilities/context/index.md +7 -0
- package/skills/uipath-agents/references/lowcode/capabilities/integration-service/integration-service.md +5 -6
- package/skills/uipath-agents/references/lowcode/critical-rules/critical-rules.md +1 -1
- package/skills/uipath-agents/references/lowcode/evaluations/evaluation-sets.md +5 -0
- package/skills/uipath-agents/references/lowcode/project-lifecycle.md +3 -3
- package/skills/uipath-agents/references/lowcode/prompting/autonomous-agent-prompting-guide.md +3 -2
- package/skills/uipath-api-workflow/SKILL.md +2 -1
- package/skills/uipath-api-workflow/references/cli-reference.md +3 -3
- package/skills/uipath-coded-apps/SKILL.md +3 -2
- package/skills/uipath-coded-apps/assets/fixtures/governance-dashboard-starter-kit.tar.gz +0 -0
- package/skills/uipath-coded-apps/assets/templates/web-app-template.md +1 -1
- package/skills/uipath-coded-apps/references/create-web-app.md +60 -48
- package/skills/uipath-coded-apps/references/dashboards/CAPABILITY.md +2 -2
- package/skills/uipath-coded-apps/references/dashboards/plugins/build/impl.md +2 -2
- package/skills/uipath-coded-apps/references/dashboards/primitives/tier-resolution.md +16 -16
- package/skills/uipath-coded-apps/references/oauth-scopes.md +28 -272
- package/skills/uipath-coded-apps/references/sdk/action-center.md +26 -243
- package/skills/uipath-coded-apps/references/sdk/agents.md +20 -130
- package/skills/uipath-coded-apps/references/sdk/conversational-agent.md +52 -706
- package/skills/uipath-coded-apps/references/sdk/data-fabric.md +20 -237
- package/skills/uipath-coded-apps/references/sdk/feedback.md +4 -139
- package/skills/uipath-coded-apps/references/sdk/governance-traces.md +7 -55
- package/skills/uipath-coded-apps/references/sdk/governance.md +4 -44
- package/skills/uipath-coded-apps/references/sdk/imports.md +77 -35
- package/skills/uipath-coded-apps/references/sdk/maestro.md +29 -406
- package/skills/uipath-coded-apps/references/sdk/orchestrator.md +30 -324
- package/skills/uipath-coded-apps/references/sdk/pagination.md +9 -67
- package/skills/uipath-coded-apps/references/sdk/traces.md +8 -43
- package/skills/uipath-functions/SKILL.md +23 -23
- package/skills/uipath-governance/SKILL.md +5 -4
- package/skills/uipath-governance/references/cli-cheatsheet.md +2 -1
- package/skills/uipath-governance/references/compliance-pack/coverage/impl.md +143 -58
- package/skills/uipath-governance/references/compliance-pack/restore/impl.md +61 -0
- package/skills/uipath-human-in-the-loop/SKILL.md +4 -2
- package/skills/uipath-insights/SKILL.md +17 -18
- package/skills/uipath-ixp/SKILL.md +12 -7
- package/skills/uipath-ixp/references/cli-reference.md +71 -9
- package/skills/uipath-ixp/references/improve-prompts-guide.md +23 -9
- package/skills/uipath-ixp/references/label-documents-guide.md +33 -5
- package/skills/uipath-maestro-bpmn/SKILL.md +15 -14
- package/skills/uipath-maestro-bpmn/references/cli-conventions.md +15 -6
- package/skills/uipath-maestro-bpmn/references/structural-bpmn.md +18 -17
- package/skills/uipath-maestro-case/SKILL.md +46 -33
- package/skills/uipath-maestro-case/assets/templates/sdd-template.md +77 -37
- package/skills/uipath-maestro-case/assets/templates/sdd-viewer.html +0 -2
- package/skills/uipath-maestro-case/references/bindings-and-expressions.md +3 -1
- package/skills/uipath-maestro-case/references/bindings-v2-sync.md +2 -2
- package/skills/uipath-maestro-case/references/brownfield.md +15 -5
- package/skills/uipath-maestro-case/references/case-commands.md +19 -3
- package/skills/uipath-maestro-case/references/case-editing-operations.md +24 -21
- package/skills/uipath-maestro-case/references/case-schema.md +38 -16
- package/skills/uipath-maestro-case/references/connector-trigger-common.md +15 -8
- package/skills/uipath-maestro-case/references/evals/evals.json +35 -18
- package/skills/uipath-maestro-case/references/implementation.md +86 -71
- package/skills/uipath-maestro-case/references/phase-0-interview.md +92 -23
- package/skills/uipath-maestro-case/references/phased-execution.md +70 -55
- package/skills/uipath-maestro-case/references/placeholder-tasks.md +5 -5
- package/skills/uipath-maestro-case/references/planning.md +57 -9
- package/skills/uipath-maestro-case/references/plugins/case/impl-json.md +7 -5
- package/skills/uipath-maestro-case/references/plugins/case/planning.md +1 -1
- package/skills/uipath-maestro-case/references/plugins/conditions/case-exit-conditions/impl-json.md +5 -5
- package/skills/uipath-maestro-case/references/plugins/conditions/stage-entry-conditions/impl-json.md +41 -5
- package/skills/uipath-maestro-case/references/plugins/conditions/stage-entry-conditions/planning.md +27 -3
- package/skills/uipath-maestro-case/references/plugins/conditions/stage-exit-conditions/impl-json.md +6 -6
- package/skills/uipath-maestro-case/references/plugins/conditions/stage-exit-conditions/planning.md +3 -1
- package/skills/uipath-maestro-case/references/plugins/conditions/task-entry-conditions/impl-json.md +20 -7
- package/skills/uipath-maestro-case/references/plugins/conditions/task-entry-conditions/planning.md +37 -4
- package/skills/uipath-maestro-case/references/plugins/sla/impl-json.md +24 -13
- package/skills/uipath-maestro-case/references/plugins/sla/planning.md +9 -3
- package/skills/uipath-maestro-case/references/plugins/stages/impl-json.md +4 -0
- package/skills/uipath-maestro-case/references/plugins/stages/planning.md +4 -1
- package/skills/uipath-maestro-case/references/plugins/tasks/action/impl-json.md +3 -1
- package/skills/uipath-maestro-case/references/plugins/tasks/action/planning.md +2 -0
- package/skills/uipath-maestro-case/references/plugins/tasks/agent/impl-json.md +3 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/agent/planning.md +4 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/api-workflow/impl-json.md +3 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/api-workflow/planning.md +4 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/case-management/impl-json.md +3 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/case-management/planning.md +4 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/connector-activity/impl-json.md +1 -1
- package/skills/uipath-maestro-case/references/plugins/tasks/connector-activity/planning.md +2 -0
- package/skills/uipath-maestro-case/references/plugins/tasks/connector-trigger/impl-json.md +1 -1
- package/skills/uipath-maestro-case/references/plugins/tasks/connector-trigger/planning.md +2 -0
- package/skills/uipath-maestro-case/references/plugins/tasks/create-inline-common.md +1 -1
- package/skills/uipath-maestro-case/references/plugins/tasks/process/impl-json.md +3 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/process/planning.md +6 -4
- package/skills/uipath-maestro-case/references/plugins/tasks/rpa/impl-json.md +3 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/rpa/planning.md +4 -2
- package/skills/uipath-maestro-case/references/plugins/tasks/wait-for-timer/impl-json.md +4 -3
- package/skills/uipath-maestro-case/references/plugins/tasks/wait-for-timer/planning.md +4 -0
- package/skills/uipath-maestro-case/references/plugins/triggers/event/impl-json.md +17 -14
- package/skills/uipath-maestro-case/references/plugins/triggers/event/planning.md +1 -1
- package/skills/uipath-maestro-case/references/plugins/triggers/manual/impl-json.md +13 -10
- package/skills/uipath-maestro-case/references/plugins/triggers/timer/impl-json.md +18 -16
- package/skills/uipath-maestro-case/references/plugins/triggers/timer/planning.md +2 -2
- package/skills/uipath-maestro-case/references/plugins/variables/bindings/impl-json.md +1 -1
- package/skills/uipath-maestro-case/references/plugins/variables/global-vars/impl-json.md +11 -9
- package/skills/uipath-maestro-case/references/plugins/variables/io-binding/impl-json.md +6 -2
- package/skills/uipath-maestro-case/references/plugins/variables/io-binding/planning.md +19 -1
- package/skills/uipath-maestro-case/references/registry-discovery.md +3 -3
- package/skills/uipath-maestro-case/references/sdd-generation-rules.md +155 -51
- package/skills/uipath-maestro-case/references/sla-response-shapes.md +74 -0
- package/skills/uipath-maestro-flow/SKILL.md +4 -3
- package/skills/uipath-maestro-flow/references/author/CAPABILITY.md +3 -0
- package/skills/uipath-maestro-flow/references/author/references/editing-operations-json.md +10 -17
- package/skills/uipath-maestro-flow/references/author/references/editing-operations.md +1 -1
- package/skills/uipath-maestro-flow/references/author/references/greenfield.md +8 -6
- package/skills/uipath-maestro-flow/references/author/references/planning-impl.md +1 -1
- package/skills/uipath-maestro-flow/references/author/references/plugins/agent/impl.md +4 -9
- package/skills/uipath-maestro-flow/references/author/references/plugins/agentic-process/impl.md +3 -7
- package/skills/uipath-maestro-flow/references/author/references/plugins/api-workflow/impl.md +5 -8
- package/skills/uipath-maestro-flow/references/author/references/plugins/connector/impl.md +11 -4
- package/skills/uipath-maestro-flow/references/author/references/plugins/flow/impl.md +3 -7
- package/skills/uipath-maestro-flow/references/author/references/plugins/inline-agent/impl.md +14 -17
- package/skills/uipath-maestro-flow/references/author/references/plugins/ixp/impl.md +60 -13
- package/skills/uipath-maestro-flow/references/author/references/plugins/queue/impl.md +2 -14
- package/skills/uipath-maestro-flow/references/author/references/plugins/rpa/impl.md +4 -9
- package/skills/uipath-maestro-flow/references/author/references/plugins/script/impl.md +3 -0
- package/skills/uipath-maestro-flow/references/author/references/plugins/subflow/impl.md +5 -9
- package/skills/uipath-maestro-flow/references/author/references/plugins/transform/impl.md +13 -0
- package/skills/uipath-maestro-flow/references/shared/action-nodes.md +2 -2
- package/skills/uipath-maestro-flow/references/shared/file-format.md +16 -12
- package/skills/uipath-maestro-flow/references/shared/variables-and-expressions.md +3 -3
- package/skills/uipath-planner/SKILL.md +1 -1
- package/skills/uipath-planner/references/non-pdd-lane-guide.md +1 -1
- package/skills/uipath-platform/SKILL.md +1 -1
- package/skills/uipath-platform/references/data-fabric/bulk-import.md +10 -27
- package/skills/uipath-platform/references/data-fabric/choice-sets.md +7 -64
- package/skills/uipath-platform/references/data-fabric/data-fabric.md +76 -267
- package/skills/uipath-platform/references/data-fabric/entity-schema.md +23 -99
- package/skills/uipath-platform/references/data-fabric/file-attachments.md +5 -28
- package/skills/uipath-platform/references/data-fabric/filter-platform-contract.md +2 -2
- package/skills/uipath-platform/references/data-fabric/records-query.md +11 -32
- package/skills/uipath-platform/references/integration-service/reference-resolution.md +6 -2
- package/skills/uipath-platform/references/licensing/consumables-report.md +18 -0
- package/skills/uipath-platform/references/licensing/licensing.md +1 -1
- package/skills/uipath-platform/references/orchestrator/run-jobs.md +9 -2
- package/skills/uipath-platform/references/orchestrator/setup-environment.md +9 -0
- package/skills/uipath-platform/references/traces/feedback.md +4 -1
- package/skills/uipath-process-mining/SKILL.md +97 -0
- package/skills/uipath-process-mining/references/app-types.md +66 -0
- package/skills/uipath-process-mining/references/data-model.md +130 -0
- package/skills/uipath-process-mining/references/lifecycle-and-rbac.md +67 -0
- package/skills/uipath-process-mining/references/model-editing.md +112 -0
- package/skills/uipath-process-mining/references/pre-flight.md +119 -0
- package/skills/uipath-process-mining/references/querying.md +66 -0
- package/skills/uipath-process-mining/references/transformations.md +80 -0
- package/skills/uipath-process-mining/references/uip-pm-cli.md +145 -0
- package/skills/uipath-review/SKILL.md +23 -18
- package/skills/uipath-review/references/agents/agent-grading-rubric.md +1 -1
- package/skills/uipath-review/references/agents/agent-review-checklist.md +0 -4
- package/skills/uipath-review/references/agents/agents-coded-rules.md +1 -10
- package/skills/uipath-review/references/agents/agents-lowcode-rules.md +3 -6
- package/skills/uipath-review/references/agents/guardrails/coded-guardrails-review.md +62 -14
- package/skills/uipath-review/references/agents/guardrails/guardrails-review.md +60 -4
- package/skills/uipath-review/references/review-workflow-guide.md +3 -2
- package/skills/uipath-review/references/rule-catalog-workflow.md +4 -5
- package/skills/uipath-rpa/.maintenance/pattern-card-maintenance.md +20 -0
- package/skills/uipath-rpa/SKILL.md +57 -55
- package/skills/uipath-rpa/agents/uipath-project-discovery-agent.md +75 -19
- package/skills/uipath-rpa/assets/codedworkflow-template.md +245 -11
- package/skills/uipath-rpa/references/cli-reference.md +229 -6
- package/skills/uipath-rpa/references/coded/codedworkflow-reference.md +158 -2
- package/skills/uipath-rpa/references/coded/integration-service-guide.md +6 -5
- package/skills/uipath-rpa/references/coded/operations-guide.md +273 -5
- package/skills/uipath-rpa/references/coded-vs-xaml-guide.md +3 -3
- package/skills/uipath-rpa/references/common-pattern-card.md +303 -0
- package/skills/uipath-rpa/references/data-manipulation-guide.md +18 -3
- package/skills/uipath-rpa/references/debugging.md +0 -2
- package/skills/uipath-rpa/references/environment-setup.md +309 -1
- package/skills/uipath-rpa/references/error-handling-guide.md +1 -1
- package/skills/uipath-rpa/references/execution-maps-guide.md +110 -0
- package/skills/uipath-rpa/references/is-connector-xaml-guide.md +58 -4
- package/skills/uipath-rpa/references/legacy/activity-docs/Excel.md +1 -1
- package/skills/uipath-rpa/references/legacy/activity-docs/_DU-PROCESS.md +0 -2
- package/skills/uipath-rpa/references/legacy/activity-docs/_INDEX.md +2 -2
- package/skills/uipath-rpa/references/legacy/activity-docs/_PATTERNS.md +1 -1
- package/skills/uipath-rpa/references/legacy/activity-docs/_REFRAMEWORK.md +2 -7
- package/skills/uipath-rpa/references/legacy/cli-reference.md +599 -0
- package/skills/uipath-rpa/references/legacy/error-handling-guide.md +2 -2
- package/skills/uipath-rpa/references/legacy/legacy-mode-guide.md +16 -16
- package/skills/uipath-rpa/references/legacy/project-organization-guide.md +2 -2
- package/skills/uipath-rpa/references/legacy/selector-guide.md +163 -1
- package/skills/uipath-rpa/references/legacy/testing-guide.md +246 -3
- package/skills/uipath-rpa/references/legacy/xaml-basics-and-rules.md +267 -2
- package/skills/uipath-rpa/references/library-authoring-guide.md +4 -3
- package/skills/uipath-rpa/references/testing-guide.md +2 -28
- package/skills/uipath-rpa/references/trigger-pattern-guide.md +1 -1
- package/skills/uipath-rpa/references/xaml/canvas-layout-guide.md +140 -33
- package/skills/uipath-rpa/references/xaml/common-pitfalls.md +57 -240
- package/skills/uipath-rpa/references/xaml/csharp-activity-binding-guide.md +42 -2
- package/skills/uipath-rpa/references/xaml/long-running-workflow-guide.md +1 -1
- package/skills/uipath-rpa/references/xaml/xaml-basics-and-rules.md +194 -228
- package/skills/uipath-solution/references/activate-and-manage.md +22 -0
- package/skills/uipath-solution/references/develop-solution.md +26 -2
- package/skills/uipath-solution/references/pack-and-deploy.md +43 -9
- package/skills/uipath-test/SKILL.md +4 -4
- package/skills/uipath-test/references/playwright-first-mile-guide.md +5 -4
- package/skills/uipath-test/references/publish-and-link-guide.md +2 -2
- package/skills/uipath-troubleshoot/references/activity-packages/classic-activities/playbooks/click-silent-no-op.md +5 -5
- package/skills/uipath-troubleshoot/references/activity-packages/classic-activities/playbooks/queue-operation-failed.md +20 -4
- package/skills/uipath-troubleshoot/references/activity-packages/classic-activities/summary.md +1 -1
- package/skills/uipath-troubleshoot/references/activity-packages/csv-activities/playbooks/read-csv-file-not-found.md +12 -0
- package/skills/uipath-troubleshoot/references/activity-packages/mail-activities/playbooks/send-outlook-mail-failures.md +12 -1
- package/skills/uipath-troubleshoot/references/activity-packages/system-activities/playbooks/get-asset-activity-bug-silent-failure.md +2 -1
- package/skills/uipath-troubleshoot/references/activity-packages/terminal-activities/playbooks/terminal-session-connection-failed.md +5 -1
- package/skills/uipath-troubleshoot/references/activity-packages/ui-automation/playbooks/click-silent-no-op.md +5 -5
- package/skills/uipath-troubleshoot/references/activity-packages/ui-automation/playbooks/dependency-version-conflict.md +27 -6
- package/skills/uipath-troubleshoot/references/activity-packages/ui-automation/playbooks/napplicationcard-view-generation-failed.md +10 -0
- package/skills/uipath-troubleshoot/references/activity-packages/ui-automation/playbooks/scope-container-wrong-page.md +1 -1
- package/skills/uipath-troubleshoot/references/activity-packages/ui-automation/summary.md +1 -1
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/overview.md +4 -0
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/playbooks/http-request-auth-401-403.md +44 -0
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/playbooks/http-request-connection-failure.md +2 -1
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/playbooks/http-request-content-type-rejected.md +37 -0
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/playbooks/http-request-proxy-blocked.md +39 -0
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/playbooks/package-version-mismatch.md +42 -0
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/playbooks/securestring-misuse-analyzer.md +41 -0
- package/skills/uipath-troubleshoot/references/activity-packages/web-activities/summary.md +5 -0
- package/skills/uipath-troubleshoot/references/products/integration-service/playbooks/connector-null-reference.md +14 -1
- package/skills/uipath-troubleshoot/references/products/integration-service/playbooks/connector-runtime-exception.md +2 -0
- package/skills/uipath-troubleshoot/references/products/integration-service/playbooks/is-activities-prerelease-not-found.md +39 -0
- package/skills/uipath-troubleshoot/references/products/integration-service/playbooks/response-content-too-large.md +41 -0
- package/skills/uipath-troubleshoot/references/products/integration-service/summary.md +9 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/console-conflict-login-to-console.md +40 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/credential-store-unavailable.md +42 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/executor-start-transient-rerun.md +49 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/job-consecutive-system-exceptions.md +47 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/job-faulted-session-timeout.md +19 -19
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/job-output-too-large.md +47 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/job-stopped-generic-exit-code.md +55 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/known-issue-robot-defect.md +40 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/platform-incident-correlation.md +45 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/screen-capture-handle-invalid.md +43 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/serverless-license-quota.md +43 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/serverless-time-limit-exceeded.md +34 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/playbooks/workstation-in-use-machine-slots.md +40 -0
- package/skills/uipath-troubleshoot/references/products/orchestrator/summary.md +13 -1
- package/version-manifest.json +2 -2
- package/skills/uipath-maestro-bpmn/validator/README.md +0 -224
- package/skills/uipath-maestro-bpmn/validator/model.mjs +0 -419
- package/skills/uipath-maestro-bpmn/validator/package.json +0 -17
- package/skills/uipath-maestro-bpmn/validator/rules.mjs +0 -1403
- package/skills/uipath-maestro-bpmn/validator/samples/invalid-conditional-and-variable.bpmn +0 -25
- package/skills/uipath-maestro-bpmn/validator/samples/valid-baseline.bpmn +0 -52
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/A.2.0.bpmn +0 -157
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/A.2.1.bpmn +0 -333
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/B.1.0.bpmn +0 -598
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/B.2.0.bpmn +0 -1709
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/C.2.0.bpmn +0 -564
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/C.3.0.bpmn +0 -671
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/C.4.0.bpmn +0 -1045
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/C.5.0.bpmn +0 -1176
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/C.6.0.bpmn +0 -670
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/C.7.0.bpmn +0 -466
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/Can_Parse_Complex_Process_With_Task_Gateway_BoundaryEvent_etc.bpmn +0 -74
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/ExclusiveGatewayDefaultFlow.bpmn +0 -32
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/ExternalAgentWorkflow.bpmn +0 -62
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/Golden_Scenario.initial.bpmn +0 -361
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/InclusiveJoinRouteAwayBranch.bpmn +0 -62
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/Parse_AsyncExecution_And_Create_CorrectModel.bpmn +0 -74
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/Parse_IXP_ExtractionValidation_And_Create_CorrectModel.bpmn +0 -35
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/Parse_IXP_Extraction_FileUpload_And_Create_CorrectModel.bpmn +0 -33
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/Parse_IXP_Extraction_JobAttachment_And_Create_CorrectModel.bpmn +0 -35
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/Parse_SubProcess_With_Multiple_Element_Types.bpmn +0 -76
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/StartEventWithOutputs.bpmn +0 -36
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/StartGatewayEnd.bpmn +0 -44
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/all elements.bpmn +0 -516
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/all_sequence_flow_types.bpmn +0 -173
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/demo.bpmn +0 -181
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/subprocess-example-001-collapsed.bpmn +0 -126
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/subprocess-example-001-expanded.bpmn +0 -122
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/expected-findings/subprocess-example-003-collapsed_deeply-nested.bpmn +0 -438
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/A.1.0.bpmn +0 -87
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/A.3.0.bpmn +0 -165
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/ApiWorkflow.bpmn +0 -39
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/BpmnNestedSubProcessTests.bpmn +0 -102
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/BpmnTimerBoundaryEvents.bpmn +0 -160
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/BpmnXmlWithCatchAllErrorEventSubProcess.bpmn +0 -45
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/BpmnXmlWithSpecificErrorEventSubProcess.bpmn +0 -46
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/CaseManagementWithConstantIdentifier.bpmn +0 -218
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/ErrorBoundary.bpmn +0 -78
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/ErrorPropagationInEventSubprocess.bpmn +0 -340
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/EventBasedGatewayFirstCatcherWins.bpmn +0 -56
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/Example-EventBasedGateway.bpmn +0 -117
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/ExclusiveGatewayConditional.bpmn +0 -45
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/ExclusiveGatewaySharedEndEvent.bpmn +0 -45
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/ExclusiveWithParallelGateway.bpmn +0 -68
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/FourScriptTasks.bpmn +0 -84
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/HitlTaskOnly.bpmn +0 -55
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/InclusiveGatewayForkJoin.bpmn +0 -69
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/Parse_BPMN_Elements_And_Create_CorrectModel.bpmn +0 -20
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/Parse_HttpRequest_ServiceTask_And_Create_Correct_Model.bpmn +0 -34
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/Parse_MessageBoundaryEvent_And_Create_CorrectModel.bpmn +0 -87
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/Parse_Script_Task_V2_And_Create_Correct_Model.bpmn +0 -31
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/Parse_Sets_Containers_Properly.bpmn +0 -129
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/ScriptWritesVariableThenGatewayBranches.bpmn +0 -59
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/boundaryevent.bpmn +0 -30
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/collapsed-subprocess.bpmn +0 -83
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/connectable-types.bpmn +0 -85
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/extensions-orchestrator-start-job.bpmn +0 -80
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/multiparticipantpool.bpmn +0 -77
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/nestedsubprocess.bpmn +0 -36
- package/skills/uipath-maestro-bpmn/validator/test/fixtures/known-good/simple.bpmn +0 -59
- package/skills/uipath-maestro-bpmn/validator/test/integration.test.mjs +0 -146
- package/skills/uipath-maestro-bpmn/validator/test/model-helpers.mjs +0 -42
- package/skills/uipath-maestro-bpmn/validator/test/ported-rule-tests.mjs +0 -983
- package/skills/uipath-maestro-bpmn/validator/test/run-tests.mjs +0 -530
- package/skills/uipath-maestro-bpmn/validator/uipath-moddle.v1.json +0 -715
- package/skills/uipath-maestro-bpmn/validator/validate-bpmn.mjs +0 -164
- package/skills/uipath-review/references/agents/agents-common-rules.md +0 -32
- package/skills/uipath-rpa/assets/before-after-hooks-template.md +0 -115
- package/skills/uipath-rpa/assets/helper-utility-template.md +0 -22
- package/skills/uipath-rpa/assets/testcase-template.md +0 -92
- package/skills/uipath-rpa/references/coded/coding-guidelines.md +0 -255
- package/skills/uipath-rpa/references/coded/inspect-package-guide.md +0 -80
- package/skills/uipath-rpa/references/coded/third-party-packages-guide.md +0 -67
- package/skills/uipath-rpa/references/connector-capabilities.md +0 -79
- package/skills/uipath-rpa/references/legacy/activity-docs/Testing.md +0 -95
- package/skills/uipath-rpa/references/legacy/activity-docs/UIAutomation.md +0 -159
- package/skills/uipath-rpa/references/legacy/common-pitfalls.md +0 -318
- package/skills/uipath-rpa/references/legacy/discovery-workflow.md +0 -147
- package/skills/uipath-rpa/references/legacy/environment-setup.md +0 -78
- package/skills/uipath-rpa/references/legacy/project-structure.md +0 -206
- package/skills/uipath-rpa/references/legacy/test-data-guide.md +0 -142
- package/skills/uipath-rpa/references/legacy/validation-and-fixing.md +0 -154
- package/skills/uipath-rpa/references/project-structure-guide.md +0 -168
- package/skills/uipath-rpa/references/project-structure.md +0 -135
- package/skills/uipath-rpa/references/publishing-guide.md +0 -80
- package/skills/uipath-rpa/references/validation-guide.md +0 -170
- package/skills/uipath-rpa/references/xaml/csharp-expression-pitfalls.md +0 -43
- package/skills/uipath-rpa/references/xaml/flowchart-guide.md +0 -113
- package/skills/uipath-rpa/references/xaml/workflow-guide.md +0 -258
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
The read-only **review** counterpart of the `uipath-agents` coded guardrail recommend/validate capability. It
|
|
4
4
|
powers the coded guardrail judgment rules in [`../agents-coded-rules.md`](../agents-coded-rules.md)
|
|
5
|
-
§GuardrailsChecker. Run it during a **coded** agent review (SKILL.md Step 2.5b) **after** `uip codedagent review`
|
|
5
|
+
§GuardrailsChecker. Run it during a **coded** agent review (SKILL.md Step 2.5b) **after** `uip codedagent review` <!-- uip-check-skip -->
|
|
6
6
|
(Step 2.5a). Two modes:
|
|
7
7
|
|
|
8
8
|
- **Audit Mode** — the agent already wires guardrails → are they *effective, appropriate, and actually wired*?
|
|
@@ -13,7 +13,7 @@ powers the coded guardrail judgment rules in [`../agents-coded-rules.md`](../age
|
|
|
13
13
|
This is **review only** — never write, fix, or run `uip codedagent` mutating commands. The reviewer emits
|
|
14
14
|
findings; the user (or the `uipath-agents` skill) applies them.
|
|
15
15
|
|
|
16
|
-
> **Boundary with `uip codedagent review` — do not double-flag.** The review CLI owns every **deterministic**
|
|
16
|
+
> **Boundary with `uip codedagent review` — do not double-flag.** <!-- uip-check-skip --> The review CLI owns every **deterministic**
|
|
17
17
|
> coded guardrail check and emits them as rule IDs: `CODED_GUARDRAIL_WRONG_IMPORT` (LangChain agent imports
|
|
18
18
|
> guardrails from `uipath.platform.guardrails` and never from `uipath_langchain.guardrails`, so the adapter never
|
|
19
19
|
> registers and the guardrail silently no-ops), `CODED_GUARDRAIL_TOOL_SCOPE_NO_TOOLS` (a Tool-scope middleware with
|
|
@@ -23,6 +23,36 @@ findings; the user (or the `uipath-agents` skill) applies them.
|
|
|
23
23
|
> all, whether a decorator is wired where it will actually wrap the target, and whether a guardrail the agent should
|
|
24
24
|
> have is missing. Never re-describe a CLI deterministic finding here.
|
|
25
25
|
|
|
26
|
+
## Deterministic CLI fast path — completed deliverable before Step 0
|
|
27
|
+
|
|
28
|
+
If `uip codedagent review` returns any `Data.Issues[]` entry whose `RuleId` starts with <!-- uip-check-skip -->
|
|
29
|
+
`CODED_GUARDRAIL_`, **immediately create or update the requested review report before any catalog, validator-list,
|
|
30
|
+
SDK-documentation, package research, or general architecture analysis**. This report is the completed deliverable
|
|
31
|
+
for the deterministic guardrail path, not an in-progress checkpoint, and
|
|
32
|
+
contains at minimum:
|
|
33
|
+
|
|
34
|
+
1. the project and review scope;
|
|
35
|
+
2. the `uip codedagent review` command and `Data.Grade`; <!-- uip-check-skip -->
|
|
36
|
+
3. every emitted `CODED_GUARDRAIL_*` issue with its `RuleId`, `Severity`, `Description`, `File`, and `SuggestedFix`
|
|
37
|
+
copied verbatim; and
|
|
38
|
+
4. an explicit note that the CLI finding is authoritative and the flagged guardrail was excluded from judgment
|
|
39
|
+
re-verification.
|
|
40
|
+
|
|
41
|
+
The CLI description and suggested fix are authoritative. Do not re-verify, rename, reword, or supplement a
|
|
42
|
+
deterministic finding by fetching SDK documentation, installing or inspecting packages, or probing framework APIs.
|
|
43
|
+
Exclude every CLI-flagged guardrail from Step 0 class mapping and Audit Mode. Step 0 may still run **after the
|
|
44
|
+
report** only when source inspection has already identified a separate unflagged guardrail or distinct missing-
|
|
45
|
+
guardrail recommendation.
|
|
46
|
+
|
|
47
|
+
After saving this report, **return it immediately and end the current review turn**. Do not continue into catalog,
|
|
48
|
+
validator-list, SDK-doc, dependency, general checklist, or architecture work merely to make the report broader.
|
|
49
|
+
Continue beyond the deterministic report only when the user's initial request explicitly asks for an exhaustive
|
|
50
|
+
review or names additional non-guardrail checks. Preserve the deterministic fields verbatim if a later request
|
|
51
|
+
extends the report.
|
|
52
|
+
|
|
53
|
+
If the CLI does not emit `Data.Issues[]`, do not invent a substitute `CODED_GUARDRAIL_*` rule ID. Report a
|
|
54
|
+
source-observed problem as rule-ID-less prose and list the deterministic CLI rule as skipped.
|
|
55
|
+
|
|
26
56
|
Like the recommend capability, this is **live-catalog driven** — the catalog's authored fields (`when_to_use`,
|
|
27
57
|
`use_cases`, `security_risk_addressed`, `when_not_to_use`, `security_category`, `examples[].config`) drive every
|
|
28
58
|
decision. The coded vocabulary (Python class names, scopes, entity enums) comes from the SDK docs. Do not hardcode
|
|
@@ -32,10 +62,12 @@ which guardrail fits which agent, or which Python class implements which validat
|
|
|
32
62
|
|
|
33
63
|
## Step 0 — Fetch Catalog, Available Validators, and SDK Docs
|
|
34
64
|
|
|
35
|
-
Run this once when the coded agent
|
|
36
|
-
`create_agent(middleware=[...])` or any `@guardrail(...)` decorator) **or** the
|
|
37
|
-
|
|
38
|
-
|
|
65
|
+
Run this once when the coded agent has at least one **unflagged** wired guardrail to audit (any
|
|
66
|
+
`*UiPath…Middleware(...)` inside `create_agent(middleware=[...])` or any `@guardrail(...)` decorator) **or** the
|
|
67
|
+
agent matches a catalog use case for a distinct missing-guardrail recommendation. A guardrail already flagged by
|
|
68
|
+
`uip codedagent review` does not, by itself, trigger Step 0. <!-- uip-check-skip --> This is the read-only review counterpart of the
|
|
69
|
+
guardrail recommend capability — it runs the same Step 0 fetches (specified in full below) but emits findings
|
|
70
|
+
instead of writing code.
|
|
39
71
|
|
|
40
72
|
### Catalog (cacheable — 30-minute TTL)
|
|
41
73
|
|
|
@@ -62,7 +94,7 @@ uip agent guardrails list --output json
|
|
|
62
94
|
|
|
63
95
|
Build a `{ validatorId: status }` lookup from the `Data` array (use only `Status == "Available"`).
|
|
64
96
|
|
|
65
|
-
### SDK Docs (
|
|
97
|
+
### SDK Docs (required when Step 0 needs Python class names)
|
|
66
98
|
|
|
67
99
|
Coded agents reference guardrails by **Python class name** (`UiPathPIIDetectionMiddleware`, `PIIValidator`), not by
|
|
68
100
|
`validator_id`. Fetch the SDK doc pages via `WebFetch` to map the two:
|
|
@@ -87,6 +119,9 @@ class/scope/enum names:
|
|
|
87
119
|
scopes, stages, and entity enums.
|
|
88
120
|
3. Neither reachable → SDK-docs skip path in the next section.
|
|
89
121
|
|
|
122
|
+
Stop at the first successful documentation source. Guardrail review must not install or download dependencies,
|
|
123
|
+
inspect unrelated framework APIs, or search package internals beyond the documented fallback modules above.
|
|
124
|
+
|
|
90
125
|
### If the catalog (or SDK docs) is unavailable
|
|
91
126
|
|
|
92
127
|
Do **not** guess:
|
|
@@ -136,6 +171,14 @@ cases:
|
|
|
136
171
|
Name the catalog-recommended action for that scope in the description. Severity `judgment` — a guardrail that breaks
|
|
137
172
|
the agent or leaves a security gap can be Critical; a milder ineffectiveness is Warning/Info.
|
|
138
173
|
|
|
174
|
+
**The catalog verdict IS the evidence — do not verify SDK behavior empirically.** Source read + catalog comparison
|
|
175
|
+
fully decides this check. Do NOT import or execute the project's dependencies, inspect `uipath_langchain` /
|
|
176
|
+
`langchain` package sources, fetch SDK documentation sites, or run the agent's factory code to "prove" an action is
|
|
177
|
+
ineffective — that forensic detour adds no admissible evidence to the finding and routinely burns the entire review
|
|
178
|
+
budget. Once the configured action diverges from the catalog's recommendation for that scope, write the finding and
|
|
179
|
+
move on to the report (the report file is the deliverable; an unwritten report scores zero regardless of analysis
|
|
180
|
+
depth).
|
|
181
|
+
|
|
139
182
|
### Relevance + Wiring Check → `CODED_GUARDRAIL_MISAPPLIED`
|
|
140
183
|
|
|
141
184
|
Two ways a format-valid guardrail can be misapplied:
|
|
@@ -206,26 +249,31 @@ Merge findings into the Step 5 "Rule Findings" subsection (SKILL.md Step 2.5b),
|
|
|
206
249
|
- Defects (`CODED_GUARDRAIL_ACTION_INEFFECTIVE`, `CODED_GUARDRAIL_MISAPPLIED`) → the `judgment` band; pick
|
|
207
250
|
Critical/Warning/Info by impact and show the reasoning.
|
|
208
251
|
- `file` = the entry `.py`; `element` = the guardrail name.
|
|
252
|
+
- If a deterministic checkpoint was created, update that same file into the complete report and remove its
|
|
253
|
+
in-progress note. Do not recreate the report in a way that drops or paraphrases checkpointed CLI findings.
|
|
209
254
|
|
|
210
255
|
---
|
|
211
256
|
|
|
212
257
|
## Critical Rules
|
|
213
258
|
|
|
214
|
-
1. **
|
|
259
|
+
1. **Checkpoint deterministic findings first.** Before Step 0 or any research, write every CLI-emitted
|
|
260
|
+
`CODED_GUARDRAIL_*` issue verbatim into the requested report; later update that same report to the complete
|
|
261
|
+
Step 5 form.
|
|
262
|
+
2. **Run after `uip codedagent review` (Step 2.5a)** and only on guardrails the CLI did not flag — never <!-- uip-check-skip -->
|
|
215
263
|
double-flag a `CODED_GUARDRAIL_WRONG_IMPORT` / `CODED_GUARDRAIL_TOOL_SCOPE_NO_TOOLS` /
|
|
216
264
|
`CODED_GUARDRAIL_INVALID_CONTRACT` deterministic finding.
|
|
217
|
-
|
|
265
|
+
3. **Catalog-driven, not hardcoded** — every audit verdict and recommendation cites a catalog field
|
|
218
266
|
(`when_not_to_use`, `when_to_use` / `use_cases`, `examples[].config.action_type`). Class/enum/import names come
|
|
219
267
|
from the SDK docs, never memory.
|
|
220
|
-
|
|
268
|
+
4. **Catalog unavailable → defer Audit Mode** (Rules Skipped), keep Recommend Mode's source-only detection with
|
|
221
269
|
generic wording and the code-only wiring half of `CODED_GUARDRAIL_MISAPPLIED`. Never guess
|
|
222
270
|
effectiveness/relevance without the catalog.
|
|
223
|
-
|
|
271
|
+
5. **Recommendations are one Info rule** (`CODED_GUARDRAIL_RECOMMENDED`), one finding per missing guardrail, details
|
|
224
272
|
in the message; signal **block/escalate** (protection) vs **log** (audit).
|
|
225
|
-
|
|
273
|
+
6. **Never silently downgrade block → log** — a security-critical guardrail at `log` is a defect
|
|
226
274
|
(`CODED_GUARDRAIL_ACTION_INEFFECTIVE`), not an acceptable choice, unless the catalog/agent shows a stated reason.
|
|
227
|
-
|
|
275
|
+
7. **Do not name platform-documented validators** (`harmful_content` / `intellectual_property` /
|
|
228
276
|
`user_prompt_attacks`) unless already present — phrase generically. `pii_detection` / `prompt_injection` may be
|
|
229
277
|
named.
|
|
230
|
-
|
|
278
|
+
8. **Review only** — emit findings; never write guardrails, edit the entry `.py`, or run mutating `uip codedagent`
|
|
231
279
|
commands.
|
|
@@ -24,6 +24,54 @@ Like the recommend capability, this is **live-catalog driven** — the catalog's
|
|
|
24
24
|
`use_cases`, `security_risk_addressed`, `when_not_to_use`, `security_category`, `examples[].config`) drive every
|
|
25
25
|
decision. Do not hardcode which guardrail fits which agent.
|
|
26
26
|
|
|
27
|
+
## Conclusive existing-guardrail fast path — completed report checkpoint
|
|
28
|
+
|
|
29
|
+
When a format-valid existing guardrail and the source it selects conclusively match a catalog
|
|
30
|
+
`when_not_to_use` clause, use this bounded sequence **before** general manual review:
|
|
31
|
+
|
|
32
|
+
1. run `uip agent review` and retain its deterministic findings and `Data.Grade`;
|
|
33
|
+
2. read the existing guardrail's exact source path, `id`, `name`, `validatorType`, action, scopes, and
|
|
34
|
+
`matchNames`, plus only the source or resource selected by that guardrail;
|
|
35
|
+
3. fetch the catalog and tenant validator list once, as specified in Step 0;
|
|
36
|
+
4. compare the configured action and scope with the catalog's exact `when_not_to_use` clause and relevant
|
|
37
|
+
`examples[].config`; and
|
|
38
|
+
5. when the clause directly matches the selected source, establish `LC_GUARDRAIL_ACTION_INEFFECTIVE` and
|
|
39
|
+
immediately save the requested report.
|
|
40
|
+
|
|
41
|
+
The saved report is a completed checkpoint, not working notes. It must include the retained CLI findings, the
|
|
42
|
+
letter-grade derivation, and the Audit Mode finding with the exact guardrail source path and identifiers, selected
|
|
43
|
+
resource path and identifiers, matched catalog clause, configured scope/action, and catalog-supported fix. If the
|
|
44
|
+
user explicitly requested additional exhaustive review, save this checkpoint first and update the same report
|
|
45
|
+
after that work completes. Otherwise, return the report and end the current review turn. Do not delay the checkpoint
|
|
46
|
+
for solution packing, eval inspection, repeated validation or catalog calls, general architecture analysis, or
|
|
47
|
+
unrelated project introspection.
|
|
48
|
+
|
|
49
|
+
This fast path requires a direct source-to-catalog contradiction, not a plausible concern. Canonical example:
|
|
50
|
+
`pii_detection` uses `Block` or `Filter` at `Tool` scope, `matchNames` selects `SendCustomerEmail`, and that tool's
|
|
51
|
+
input schema requires `recipient_email`; the catalog says that action breaks a tool that requires PII to function.
|
|
52
|
+
If the selected input is optional or the catalog clause does not directly match, continue normal Audit Mode instead.
|
|
53
|
+
|
|
54
|
+
## Missing-guardrail fast path — completed deliverable
|
|
55
|
+
|
|
56
|
+
When the source clearly matches a missing-guardrail use case and `guardrails[]` is absent or lacks the matching
|
|
57
|
+
validator, use this bounded sequence:
|
|
58
|
+
|
|
59
|
+
1. run `uip agent review` and retain its deterministic findings and `Data.Grade`;
|
|
60
|
+
2. read the system prompt, schema property names, tool/resource names, and existing `guardrails[]` from the target
|
|
61
|
+
agent source;
|
|
62
|
+
3. fetch the catalog and tenant validator list once, as specified in Step 0;
|
|
63
|
+
4. establish the `LC_GUARDRAIL_RECOMMENDED` finding using R2–R5; and
|
|
64
|
+
5. immediately save the requested report with the rule ID exactly
|
|
65
|
+
`LC_GUARDRAIL_RECOMMENDED`, the exact source-evidence clause, and the R5 scope/action, then return it.
|
|
66
|
+
|
|
67
|
+
The saved report is the completed deliverable for this guardrail path. After saving it, **end the current review
|
|
68
|
+
turn**. Do not delay delivery for solution packing, eval inspection, repeated catalog/list calls, general
|
|
69
|
+
architecture analysis, or unrelated project introspection. Continue beyond it only when the user's initial request
|
|
70
|
+
explicitly asks for an exhaustive review or names additional non-guardrail checks.
|
|
71
|
+
|
|
72
|
+
`LC_GUARDRAIL_PII_MISSING`, `LC_GUARDRAIL_MISSING`, and other descriptive variants are not valid rule IDs. When
|
|
73
|
+
catalog evidence is unavailable, use rule-ID-less prose rather than inventing an identifier.
|
|
74
|
+
|
|
27
75
|
---
|
|
28
76
|
|
|
29
77
|
## Step 0 — Fetch Catalog and Available Validators
|
|
@@ -48,6 +96,9 @@ else:
|
|
|
48
96
|
- **CACHE_MISS**: fetch and save: `uip agent guardrails catalog --output json > .guardrails-catalog-cache.json`
|
|
49
97
|
(the CLI writes both success and error JSON to stdout — do not add `2>&1`).
|
|
50
98
|
|
|
99
|
+
**Never invoke `uip agent guardrails catalog` a second time in the same review.** Every later read — a quick
|
|
100
|
+
look, a `python3`/`jq` parse, a re-check — goes through `.guardrails-catalog-cache.json`, not a fresh CLI call.
|
|
101
|
+
|
|
51
102
|
### Guardrails List (NEVER cached — tenant-specific)
|
|
52
103
|
|
|
53
104
|
```bash
|
|
@@ -147,8 +198,12 @@ Default to the catalog example's `action_type`, and state which of the two the r
|
|
|
147
198
|
|
|
148
199
|
One `LC_GUARDRAIL_RECOMMENDED` (Info) per missing guardrail. The message must carry: which guardrail /
|
|
149
200
|
`security_category`, why (the matched `when_to_use` / `use_cases` item or the data flow), the recommended scope,
|
|
150
|
-
and the recommended action with the protection-vs-audit signal.
|
|
151
|
-
|
|
201
|
+
and the recommended action with the protection-vs-audit signal. It must also carry a source-evidence clause in
|
|
202
|
+
the form `<source path>: <exact matching identifier(s)>`. Copy schema property names, tool names, resource names,
|
|
203
|
+
and other matched identifiers verbatim from the source; never replace them with display-friendly prose. For a
|
|
204
|
+
schema match, cite the property path and names, for example
|
|
205
|
+
`agent.json inputSchema.properties: customer_email, full_name, ssn`. Cite the catalog's `examples[].config` in
|
|
206
|
+
the fix. Examples:
|
|
152
207
|
|
|
153
208
|
- *"Recommend a PII-detection guardrail at Agent scope with a **block** action — the input schema carries
|
|
154
209
|
`customer_email` / `ssn` (data_privacy); blocking at Agent · PRE stops unexpected PII before the LLM.
|
|
@@ -188,8 +243,9 @@ Merge findings into the Step 5 "Rule Findings" subsection (SKILL.md Step 2.5b),
|
|
|
188
243
|
(`when_not_to_use`, `when_to_use` / `use_cases`, `examples[].config.action_type`).
|
|
189
244
|
3. **Catalog unavailable → defer Audit Mode** (Rules Skipped), keep Recommend Mode's `agent.json`-only detection
|
|
190
245
|
with generic wording. Never guess effectiveness/relevance without the catalog.
|
|
191
|
-
4. **Recommendations are one Info rule** (`LC_GUARDRAIL_RECOMMENDED`), one finding per missing guardrail
|
|
192
|
-
|
|
246
|
+
4. **Recommendations are one Info rule** (`LC_GUARDRAIL_RECOMMENDED`), one finding per missing guardrail. The
|
|
247
|
+
message preserves the exact source path and matched identifiers verbatim, then signals **block/escalate**
|
|
248
|
+
(protection) vs **log** (audit).
|
|
193
249
|
5. **Never silently downgrade block → log** — a security-critical guardrail at `log` is a defect
|
|
194
250
|
(`LC_GUARDRAIL_ACTION_INEFFECTIVE`), not an acceptable choice, unless the catalog/agent shows a stated reason.
|
|
195
251
|
6. **Do not name platform-documented validators** (`harmful_content` / `intellectual_property` /
|
|
@@ -72,10 +72,10 @@ Run these commands to detect what exists in the target directory:
|
|
|
72
72
|
find . -maxdepth 1 -name "*.uipx" 2>/dev/null
|
|
73
73
|
|
|
74
74
|
# Detect all project types
|
|
75
|
-
find . -maxdepth 3 -name "project.json" -o -name "agent.json" -o -name "*.flow" -o -name "app.config.json" -o -name "project.uiproj" 2>/dev/null
|
|
75
|
+
find . -maxdepth 3 \( -type d \( -name ".agent-builder" -o -path "*/.local/build" \) \) -prune -o \( -name "project.json" -o -name "agent.json" -o -name "*.flow" -o -name "app.config.json" -o -name "project.uiproj" \) -print 2>/dev/null
|
|
76
76
|
|
|
77
77
|
# Detect coded agent markers
|
|
78
|
-
find . -maxdepth 2 \( -name "langgraph.json" -o -name "llama_index.json" -o -name "openai_agents.json" -o -name "uipath.json" \) 2>/dev/null
|
|
78
|
+
find . -maxdepth 2 \( -type d \( -name ".agent-builder" -o -path "*/.local/build" \) \) -prune -o \( -name "langgraph.json" -o -name "llama_index.json" -o -name "openai_agents.json" -o -name "uipath.json" \) -print 2>/dev/null
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
### Scope Decision Tree
|
|
@@ -173,6 +173,7 @@ Include the Workflow Analyzer rule ID (e.g., ST-NMG-001, ST-DBP-003, ST-SEC-007)
|
|
|
173
173
|
|
|
174
174
|
```bash
|
|
175
175
|
# Low-code agent
|
|
176
|
+
uip agent refresh ./agent-directory --output json
|
|
176
177
|
uip agent validate ./agent-directory --output json
|
|
177
178
|
|
|
178
179
|
# Coded agent — check if eval sets exist first
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Rule Catalog — Workflow (SKILL.md Step 2.5)
|
|
2
2
|
|
|
3
|
-
Step 2.5 of the review workflow. Runs **after** Step 2 (`uip agent validate`
|
|
3
|
+
Step 2.5 of the review workflow. Runs **after** Step 2 (`uip agent refresh` then `uip agent validate` for low-code agents, plus related CLI validation) and **before** Step 3 (manual checklist review). Adds rule-ID-level findings to the report from two sources, in order:
|
|
4
4
|
|
|
5
5
|
1. **The review CLI** (`uip agent review` / `uip codedagent review`) — all deterministic static checks.
|
|
6
6
|
2. **The judgment catalog** (`agents-*-rules.md`) — checks that require the agent to read source and reason.
|
|
@@ -55,10 +55,9 @@ Maps project signals to the judgment catalog files that must be loaded. Extend t
|
|
|
55
55
|
|
|
56
56
|
| Signals present | Project type | Catalog files |
|
|
57
57
|
|---|---|---|
|
|
58
|
-
| `agent.json
|
|
59
|
-
|
|
|
58
|
+
| `agent.json.type == "lowCode"` | Agent (low-code) | `agents/agents-lowcode-rules.md` (+ `agents/guardrails/guardrails-review.md` when `guardrails[]` is present or a guardrail use case matches — see Step 2.5b item 3) |
|
|
59
|
+
| Python coded-agent signals or `agent.json.type == "coded"` | Agent (coded) | `agents/agents-coded-rules.md` (+ `agents/guardrails/coded-guardrails-review.md` when the entry source wires SDK guardrails or a guardrail use case matches — see Step 2.5b item 3) |
|
|
60
60
|
| `pyproject.toml` + `main.py` + `uipath.json[functions]` only (no framework config) | Agent (coded — Simple Function) | same as Agent (coded) |
|
|
61
|
-
| `agent.json` + `pyproject.toml` + `main.py` (agent-builder coded layout) | Agent (low-code + coded) | all three: common + lowcode + coded; tag each finding with its source file; also `agents/guardrails/guardrails-review.md` for the `agent.json` guardrails and `agents/guardrails/coded-guardrails-review.md` for SDK guardrails wired in the entry `.py` |
|
|
62
61
|
| `project.json` + `.xaml` / `.cs` | RPA | *(phase 2 — catalog not yet authored)* |
|
|
63
62
|
| `*.flow` + `project.uiproj` with `ProjectType: "Flow"` | Flow | *(phase 2)* |
|
|
64
63
|
| `.uipath/` or `app.config.json` | Coded App | *(phase 2)* |
|
|
@@ -87,6 +86,6 @@ Two consecutive runs over the same project produce identical findings *for the r
|
|
|
87
86
|
1. **Do not invent rule IDs.** If you observe a real issue covered by neither the review CLI nor the judgment catalog, surface it under the Critical / Warning / Info sections as a normal finding — do not promote it to a `rule_id`.
|
|
88
87
|
2. **Do not re-rank severities.** The CLI's `Severity` and the catalog's `severity` are authoritative for `error` / `warning` / `info`. For `judgment` rows, log the reasoning when picking the report band.
|
|
89
88
|
3. **Do not silently skip rules.** Every skip belongs in the report's "Rules Skipped" subsection with a reason.
|
|
90
|
-
4. **Do not run the catalog before the CLI.** Run `uip agent review` / `uip codedagent review` first (2.5a),
|
|
89
|
+
4. **Do not run the catalog before the CLI.** Run `uip agent review` / `uip codedagent review` first (2.5a); for low-code agents, `uip agent refresh` and `uip agent validate` are assumed already completed in that order (Step 2) — so the judgment catalog focuses only on reasoning the CLI cannot do.
|
|
91
90
|
5. **Do not load catalog files outside the detection table.** Loading low-code rules against a non-agent project produces false positives.
|
|
92
91
|
6. **Do not re-implement deterministic checks inline.** Counts, regex, schema-presence, and set-membership are the review CLI's job. The skill itself ships no executable code.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Pattern Card Maintenance
|
|
2
|
+
|
|
3
|
+
Regeneration procedure for [references/common-pattern-card.md](../references/common-pattern-card.md). Run when: a stamped package ships a new minor/major, a staleness report arrives (`/uipath-feedback` or repo issue), or a new pattern is added.
|
|
4
|
+
|
|
5
|
+
## Procedure
|
|
6
|
+
|
|
7
|
+
1. Scratch project (never committed): `uip rpa init --name PatternCard --location <TEMP_DIR> --template-id BlankTemplate --expression-language VisualBasic --target-framework Portable --output json`. On macOS/Linux the Helm host cannot open `Windows`-target projects — `Portable` is mandatory there.
|
|
8
|
+
2. Install every card-stamped package at the target versions: `uip rpa packages versions --package-id <Id> --include-prerelease ...` to pick, then `uip rpa packages install` (flag shape drifts across CLI builds — confirm with `--help`; current builds take a JSON array `[{"id":"...","version":"..."}]`).
|
|
9
|
+
3. One probe workflow per card entry: paste the entry's snippet inside a complete `<Activity>` root cloned from the scaffolded `Main.xaml` (namespaces + `TextExpression` blocks), adding the entry's listed prefixes.
|
|
10
|
+
4. Gate: per-file `uip rpa validate --file-path "<RELATIVE_FILE>" --project-dir "<DIR>" --output json` to 0 errors (relative path — absolute falsely fails), then `uip rpa build "<DIR>" --output json` clean. `validate` clean is NOT sufficient — namespace-registration and member-name errors surface only at `build`.
|
|
11
|
+
5. Failing entry → fix from `{PROJECT_DIR}/.local/docs/packages/<PackageId>/activities/<Activity>.md` (post-install, authoritative for the installed version), re-gate. `Cannot create unknown type` / `TypeLoadException` on a cross-platform gate usually means Windows-only activity → move the entry to the card's "Not on this card" list or validate on a Windows machine before stamping.
|
|
12
|
+
6. Update every entry's version stamp + the header package-anchor line. Entries never carry a version they were not gated against.
|
|
13
|
+
7. New pattern candidates qualify by frequency: appears in ≥2 `tests/tasks/uipath-rpa/` tasks or is a documented top user ask. Keep the card ≤ ~15 entries — it is a hot-path read, not a catalog.
|
|
14
|
+
|
|
15
|
+
## Rules
|
|
16
|
+
|
|
17
|
+
- CLI-gate before stamp — no exceptions, no "obviously fine" edits.
|
|
18
|
+
- UIA activities never enter this card (`skills/uipath-rpa/CLAUDE.md` boundary).
|
|
19
|
+
- Windows-only families (Excel X, SMTP SendMail) require a Windows-target gate; until one runs, they stay off the card with an explicit "Not on this card" note.
|
|
20
|
+
- Prose follows `.claude/rules/token-optimization.md`.
|