Skip to content
Open
Show file tree
Hide file tree
Changes from 38 commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
8f67d88
feat(uipath-doc-mode-select): add document-processing mode selection …
SummerWangUiPath Sep 21, 2026
bee7887
chore: ignore assets/memos/ source meeting memos
SummerWangUiPath Sep 24, 2026
d3780c5
feat(uipath-doc-mode-select): add batch transform mode and restructur…
SummerWangUiPath Sep 24, 2026
59acd20
test(uipath-doc-mode-select): register activation coverage and a 27-r…
SummerWangUiPath Sep 24, 2026
dbb3dd0
chore(uipath-doc-mode-select): record the Confluence case-library page
SummerWangUiPath Sep 24, 2026
967a11d
docs(uipath-doc-mode-select): ground the AH3 and PS1 observed failure…
SummerWangUiPath Sep 24, 2026
41e5ee4
docs(uipath-doc-mode-select): replace the two constructed cases with …
SummerWangUiPath Sep 24, 2026
f150fd3
fix(tests): repoint the af3 and su1 eval rows at the cases that repla…
SummerWangUiPath Sep 28, 2026
83ec58a
test(uipath-doc-mode-select): rebuild the mode-selection set from wor…
SummerWangUiPath Sep 28, 2026
4466418
test(uipath-doc-mode-select): make the mode-selection set natural-lan…
SummerWangUiPath Sep 28, 2026
a7bf01a
fix(tests): anchor the consistency analyzer on the replicate directory
SummerWangUiPath Sep 28, 2026
613d842
test(uipath-doc-mode-select): drop the NONE rows from the mode-select…
SummerWangUiPath Sep 29, 2026
87dc061
refactor(uipath-doc-mode-select): call them file handling strategies,…
SummerWangUiPath Sep 29, 2026
7a36d9b
refactor: rename uipath-doc-mode-select to uipath-doc-strategy-select
SummerWangUiPath Sep 29, 2026
9f8a044
feat(uipath-doc-strategy-select): withhold agentic search so the skil…
SummerWangUiPath Sep 30, 2026
bccb4cd
chore(uipath-doc-strategy-select): follow the Confluence page rename
SummerWangUiPath Sep 30, 2026
52a0fce
feat(uipath-doc-strategy-select): make the advanced harness selectable
SummerWangUiPath Oct 12, 2026
f67ead7
test(uipath-doc-strategy-select): rebuild the routing set for AH, the…
SummerWangUiPath Oct 12, 2026
875da4f
Revert: restore the shared activation negatives
SummerWangUiPath Oct 12, 2026
386fb7e
Merge remote-tracking branch 'origin/main' into feat/add-uipath-doc-m…
SummerWangUiPath Oct 12, 2026
f6ac244
fix(uipath-doc-strategy-select): repoint links after maestro-flow fla…
SummerWangUiPath Oct 12, 2026
645396f
fix(uipath-doc-strategy-select): add the studioweb override for maest…
SummerWangUiPath Oct 12, 2026
5a21ef1
fix(uipath-genome): register uipath-doc-strategy-select in OPERATE_SK…
SummerWangUiPath Oct 12, 2026
28ab66e
fix(uipath-doc-strategy-select): restore complete review as an SU sig…
SummerWangUiPath Oct 12, 2026
91389c0
fix(packaging): never ship a skill's working documents
SummerWangUiPath Oct 13, 2026
89208cd
feat(uipath-doc-strategy-select): withhold Classify & Split into CS-L…
SummerWangUiPath Oct 13, 2026
9a70143
fix(uipath-doc-strategy-select): six strategies, not seven, in workfl…
SummerWangUiPath Oct 13, 2026
82382bf
Merge remote-tracking branch 'origin/main' into feat/add-uipath-doc-m…
SummerWangUiPath Oct 14, 2026
32874a5
fix(uipath-doc-strategy-select): route dependent retrieval to AH, spl…
SummerWangUiPath Oct 21, 2026
3180f11
docs(uipath-doc-strategy-select): state the inline-schema versus publ…
SummerWangUiPath Oct 21, 2026
8bb3a11
fix(uipath-doc-strategy-select): bring the last three guide sites ont…
SummerWangUiPath Oct 21, 2026
cf1703e
docs(uipath-doc-strategy-select): keep the PA reinstatement spec accu…
SummerWangUiPath Oct 21, 2026
bf75a10
chore: document why the private working paths are ignored and package…
SummerWangUiPath Oct 21, 2026
3b08df5
fix(packaging): fail closed on memo sources, not just on working docu…
SummerWangUiPath Oct 21, 2026
1590eef
test(packaging): cover the plan exclusion and the tarball denylist se…
SummerWangUiPath Oct 21, 2026
a47076f
chore(uipath-doc-strategy-select): hold the reinstatement specs inter…
SummerWangUiPath Oct 22, 2026
0ad7864
fix(uipath-doc-strategy-select): the Extract rows split on the schema…
SummerWangUiPath Oct 22, 2026
8e2341a
fix(uipath-doc-strategy-select): name Classify & Split as the separat…
SummerWangUiPath Oct 22, 2026
5efd4d3
Merge remote-tracking branch 'origin/main' into feat/add-uipath-doc-m…
CalebMartinUiPath Nov 2, 2026
31aed3f
Merge remote-tracking branch 'origin/main' into feat/add-uipath-doc-m…
CalebMartinUiPath Nov 15, 2026
33ba75f
docs(uipath-doc-strategy-select): align Extract routing with the flow…
CalebMartinUiPath Nov 15, 2026
23574ac
Merge remote-tracking branch 'origin/main' into feat/add-uipath-doc-m…
CalebMartinUiPath Nov 15, 2026
eb66265
docs(uipath-doc-strategy-select): hand Classify & Split to the flow s…
CalebMartinUiPath Nov 16, 2026
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
21 changes: 21 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -104,3 +104,24 @@ tests/tasks/**/seed.json
.created-ids.jsonl
# Ephemeral solution .uipx (post_run globs it) plus debug logs:
customer-escalation-live/

# Private working material. This repository is public, and
# references/case-template.md § Publishing constraints requires every derived
# case to pass the provenance scrub before it lands.
#
# Ignoring these is necessary but not sufficient: npm's `files` allowlist
# overrides .gitignore, so a file kept out of git can still be published. They
# are therefore also kept out of every packaged path, stripped by the composer,
# and asserted on in tests/scripts/compose-skill-flavor.test.mjs.
#
# .local/ — working copies of the above, kept outside every packaged root
# assets/memos/ — source meeting memos the case library was derived from
# CASE-MEMO-MAP.md — maps case IDs to real accounts and ticket IDs
# *-LOCATIONS.md — reinstatement specs for strategies withheld from a release
#
# The last two are unanchored on purpose: the filename shape must stay ignored
# wherever it is recreated, not only at the path it sits at today.
.local/
assets/memos/
Comment thread
SummerWangUiPath marked this conversation as resolved.
Resolved
Comment thread
SummerWangUiPath marked this conversation as resolved.
Resolved
CASE-MEMO-MAP.md
*-LOCATIONS.md
4 changes: 4 additions & 0 deletions CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -257,3 +257,7 @@
/skills/uipath-vertical-solutions/ @sandeeprao-uipath @UiPath/vertical-service-approvers
/tests/tasks/uipath-vertical-solutions/ @sandeeprao-uipath @UiPath/vertical-service-approvers
/skill-flavors/studioweb/uipath-vertical-solutions/ @sandeeprao-uipath @UiPath/vertical-service-approvers

# File handling strategy selection (Extract / Summarize / Analyze files / batch transform / search / harness)
/skills/uipath-doc-strategy-select/ @SummerWangUiPath
/tests/tasks/uipath-doc-strategy-select/ @SummerWangUiPath
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ The repository ships skills covering authoring, platform operations, and diagnos
| **uipath-api-workflow** | API Workflow JSON DSL — author, run, package, publish; HTTP and Integration Service connector activities. |
| **uipath-human-in-the-loop** | Human task authoring and operations — design approval gates, escalations, and validation forms in Flow, Maestro, or coded agents; list, assign, complete, and reassign the resulting Action Center tasks. |
| **uipath-ixp** | Document Understanding (IXP) — project setup, labeling, prediction review, prompt improvement, model publishing. |
| **uipath-doc-strategy-select** | File handling strategy selection — Extract vs Summarize vs Analyze files vs batch transform vs persistent-index semantic search vs advanced harness, before authoring begins. |

### Solution & Planning

Expand Down Expand Up @@ -95,6 +96,7 @@ Every skill's maturity is tracked in [`assets/skill-status.json`](assets/skill-s
| `uipath-automationhub` | Stable |
| `uipath-coded-apps` | Stable |
| `uipath-connector-builder` | In-development |
| `uipath-doc-strategy-select` | Preview |
| `uipath-feedback` | Stable |
| `uipath-functions` | Preview |
| `uipath-genome` | Preview |
Expand Down
8 changes: 8 additions & 0 deletions assets/skill-status.json
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,14 @@
},
"last_synced": null
},
"uipath-doc-strategy-select": {
"status": "preview",
"confluence": {
"page_id": "91171553571",
"url": "https://uipath.atlassian.net/wiki/spaces/AI/pages/91171553571/INTERNAL+Mode-selection+skill+-+case+library"
},
"last_synced": "2026-09-30"
},
"uipath-feedback": {
"status": "stable",
"confluence": {
Expand Down
39 changes: 38 additions & 1 deletion scripts/compose-skill-flavor.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -395,6 +395,7 @@ function collectCanonicalFiles(repoRoot, skills, findings, sourceRoots = new Map
continue;
}
if (!entry.stats.isFile()) continue;
if (isWorkingDocument(path.basename(entry.path))) continue;
const relative = `skills/${skill}/${posixRelative(skillRoot, entry.path)}`;
canonicalFiles.set(relative, entry.path);
if (path.extname(entry.path).toLowerCase() !== ".md") continue;
Expand Down Expand Up @@ -657,6 +658,39 @@ function copyFilePreservingTimes(source, destination) {
utimesSync(destination, stats.atime, stats.mtime);
}

/**
* Working documents that live beside a skill but must never reach a consumer.
*
* `CASE-MEMO-MAP.md` maps library cases to the engagements they came from and
* names real accounts and ticket ids; it is kept out of git by a local exclude,
* which npm never reads, so without this it packs. `*-LOCATIONS.md` are
* reinstatement specs for withheld strategies — committed on purpose, but a
* consumer reading an installed skill must not find a strategy the release does
* not ship.
*
* Excluded at the canonical walk, which is the only entry point into a plan, so
* one predicate covers every built tree, staged package and tarball.
*/
export function isWorkingDocument(basename) {
Comment thread
SummerWangUiPath marked this conversation as resolved.
Resolved
return basename === "CASE-MEMO-MAP.md" || basename.endsWith("-LOCATIONS.md");
}

/**
* Private working material, identified by path rather than basename.
*
* Working documents live under `skills/` and are excluded at the canonical
* walk. Memo sources do not: they sit under `assets/`, which is a whole-root
* `files` entry copied wholesale, so nothing in the skill plan ever sees them.
* They are kept out of the repository entirely, and this predicate is the
* second line — a pack run on a machine that still has a copy fails instead of
* publishing it.
*/
export function isPrivateWorkingPath(relativePath) {
const parts = relativePath.split("/").filter((part) => part && part !== ".");
if (parts.includes("memos")) return true;
return isWorkingDocument(parts[parts.length - 1] ?? "");
}

export function materializeComposition(plan, outputDir) {
outputDir = validateOutputDirectory(outputDir);
for (const item of plan.files) {
Expand Down Expand Up @@ -837,6 +871,7 @@ function copyPayload(source, destination, label) {
const stats = safeLstat(source);
if (!stats) throw new Error(`${label} is neither a file nor directory: ${source}`);
if (stats.isFile()) {
if (isPrivateWorkingPath(path.basename(source))) return;
mkdirSync(path.dirname(destination), { recursive: true });
copyFilePreservingTimes(source, destination);
return;
Expand All @@ -846,6 +881,7 @@ function copyPayload(source, destination, label) {
chmodSync(destination, stats.mode);
for (const entry of walkTree(source)) {
const relative = path.relative(source, entry.path);
if (isPrivateWorkingPath(posixRelative(source, entry.path))) continue;
const target = path.join(destination, relative);
if (entry.stats.isDirectory()) {
mkdirSync(target, { recursive: true });
Expand Down Expand Up @@ -1395,7 +1431,8 @@ export function verifyTarball(tarball, packageDir, expectedName, expectedVersion
name.startsWith("package/skill-flavors/") ||
name.startsWith("package/tests/") ||
(name.startsWith("package/scripts/") &&
name !== "package/scripts/npm-package-lifecycle.mjs"),
name !== "package/scripts/npm-package-lifecycle.mjs") ||
isPrivateWorkingPath(name.replace(/^package\//, "")),
);
if (forbidden.length) throw new Error(`npm tarball contains source-only paths: ${forbidden.slice(0, 5).join(", ")}`);
}
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
<!--skill-flavor:harness-inline-agent:start-->
[/uipath:uipath-maestro-flow — plugins/inline-agent/planning.md](../../uipath-maestro-flow/references/author/plugins/inline-agent/planning.md).
<!--skill-flavor:harness-inline-agent:end-->
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
<!--skill-flavor:handoff-ixp:start-->
| Extract, inside a Flow — a project's trained taxonomy fields | `uipath-maestro-flow` | [/uipath:uipath-maestro-flow — plugins/ixp/planning.md](../../uipath-maestro-flow/references/author/plugins/ixp/planning.md) |
<!--skill-flavor:handoff-ixp:end-->

<!--skill-flavor:handoff-document-pipeline:start-->
<!--skill-flavor:handoff-document-pipeline:end-->

<!--skill-flavor:extract-node-choice:start-->
Extract inside a Flow is always `ixpExtract` against a project's trained taxonomy. This host documents
no inline-schema extraction node, so there is no choice to make here. The model is still addressed by
`{FolderKey, DeploymentName}`, so the version has to be deployed to an Orchestrator folder — publishing
a version is a separate IXP operation and does not supply that identity.
<!--skill-flavor:extract-node-choice:end-->

<!--skill-flavor:handoff-summarize:start-->
| Summarize, as a fixed Flow step | `uipath-maestro-flow` | [/uipath:uipath-maestro-flow — plugins/summarize/planning.md](../../uipath-maestro-flow/references/author/plugins/summarize/planning.md) |
<!--skill-flavor:handoff-summarize:end-->

<!--skill-flavor:handoff-agent:start-->
| Agent node referencing a published agent | `uipath-maestro-flow` | [/uipath:uipath-maestro-flow — plugins/agent/planning.md](../../uipath-maestro-flow/references/author/plugins/agent/planning.md) |
<!--skill-flavor:handoff-agent:end-->

<!--skill-flavor:handoff-inline-agent:start-->
| Agent defined inside the Flow | `uipath-maestro-flow` | [/uipath:uipath-maestro-flow — plugins/inline-agent/planning.md](../../uipath-maestro-flow/references/author/plugins/inline-agent/planning.md) |
<!--skill-flavor:handoff-inline-agent:end-->

<!--skill-flavor:handoff-deterministic:start-->
| Deterministic transformation, branch, or calculation | `uipath-maestro-flow` | [/uipath:uipath-maestro-flow — plugins/script/planning.md](../../uipath-maestro-flow/references/author/plugins/script/planning.md) · [transform](../../uipath-maestro-flow/references/author/plugins/transform/planning.md) · [decision](../../uipath-maestro-flow/references/author/plugins/decision/planning.md) |
<!--skill-flavor:handoff-deterministic:end-->

<!--skill-flavor:handoff-hitl:start-->
| Planned human review | `uipath-maestro-flow` · `uipath-human-in-the-loop` | [/uipath:uipath-maestro-flow — plugins/hitl/planning.md](../../uipath-maestro-flow/references/author/plugins/hitl/planning.md) |
<!--skill-flavor:handoff-hitl:end-->

<!--skill-flavor:node-palette-pointer:start-->
[/uipath:uipath-maestro-flow — planning-arch.md](../../uipath-maestro-flow/references/author/planning-arch.md)
<!--skill-flavor:node-palette-pointer:end-->

<!--skill-flavor:handoff-batch-transform:start-->
| Batch transform, per-row LLM work over a CSV | `uipath-agents` · `uipath-maestro-flow` | [/uipath:uipath-agents — batch-transform/planning.md](../../uipath-agents/references/lowcode/capabilities/built-in-tools/batch-transform/planning.md) · [/uipath:uipath-maestro-flow — plugins/batch-transform/planning.md](../../uipath-maestro-flow/references/author/plugins/batch-transform/planning.md) |
<!--skill-flavor:handoff-batch-transform:end-->
1 change: 1 addition & 0 deletions skills.sh.json
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@
"uipath-api-workflow",
"uipath-human-in-the-loop",
"uipath-ixp",
"uipath-doc-strategy-select",
"uipath-connector-builder",
"uipath-functions"
]
Expand Down
Loading
Loading