MWPW-199041: bulk-edit find IO action

[yesil]

Summary

Adds the bulk-edit-find Adobe I/O Runtime API — the Find stage of M@S bulk Find & Replace. Studio (MWPW-191300) and operators can start a cross-fragment text search, poll job progress, download match exports (JSON + CSV), upload an edited CSV subset, and remove the upload to restore full results. Replace lands separately in MWPW-199042 / PR #999.

Search targets card and collection fragments only — dictionary entries are excluded.

Two-stage search: Odin CF Search API does recall (path + fullText + optional tags/status, cursor-paged via fetchOdin), then the find worker does precision matching via SCOPE_FIELDS. * scans scoped fields only (not arbitrary CF fields). Fragment title is searchable (fragmentTitle scope or *); fragment name is never matched.

API

Base URL: https://14257-masstudio-yesil.adobeioruntime.net/api/v1/web/MerchAtScaleStudio/bulk-edit-find

Auth: Authorization: Bearer <mas-studio IMS token> (see io/studio/.env → MAS_TOKEN)

Method	Path / body	Purpose
POST	JSON { find, surface, … }	Start or reuse an async find job → 202 { jobId, reused }
GET	?jobId=	Poll progress; when exportReady, body includes presigned exports.json + exports.csv URLs
POST	?jobId= + CSV body (multipart or text/csv)	Upload edited CSV; filters exports to uploaded rows
DELETE	?jobId=	Remove uploaded CSV; restore full exports

POST find parameters

• Required: find, surface
• Optional: searchIn (* default, or prices, ctas, calloutText, productDescription, promoText, subtitle, fragmentDescription, fragmentTitle, tags, or array of scopes), locale (string or array), tags, status, matchCase, forceRefresh, supersedes (cancels a prior RUNNING job)

GET poll response

{
  "jobId": "abc…",
  "type": "find",
  "status": "DONE",
  "done": true,
  "total": 42,
  "report": { "total": 42, "byLocale": { "en_US": 30, "fr_FR": 12 } },
  "filteredByUpload": false,
  "exportReady": true,
  "exports": {
    "json": "https://…presigned…",
    "csv": "https://…presigned…"
  }
}

Result rows are not inline in the poll body — follow the presigned exports URLs (no IMS auth on redirect). .json / .csv suffixes on jobId return 400.

CSV upload rows match by (fragment_id, field, find) with scope/field aliases (e.g. productDescription ↔ cardTitle). Omitted rows are excluded from exports until upload is removed.

Architecture

• bulk-edit-find — web action: auth, job lifecycle, poll/upload/delete, export regeneration
• bulk-edit-find-worker — async worker (60 min timeout): Odin search + findMatches, writes exports on completion
• export.js — Adobe I/O Files presigned JSON/CSV exports (24 h URLs)
• Job id — SHA-256 of canonical search params (stable dedup / cache reuse)
• I/O State — RUNNING jobs TTL 30 min; completed jobs, results, uploads, reports cached 7 days (refreshed on terminal poll)
• Cooperative cancel — supersedes + forceRefresh cancel an in-flight RUNNING job before re-run; forceRefresh also clears uploads and exports

Local tooling

• io/studio/requests.http — REST Client examples
• io/studio/src/bulk-edit/README.md — API reference
• scripts/content/bulk-edit-find.mjs — run find in-process against I/O State

Out of scope

• bulk-edit-replace → MWPW-199042 / PR #999
• Studio Find & Replace UI → MWPW-191300

Resolves https://jira.corp.adobe.com/browse/MWPW-199041

QA Checklist: https://wiki.corp.adobe.com/display/adobedotcom/M@S+Engineering+QA+Use+Cases

• C1. Cover code with unit tests (150 bulk-edit tests in io/studio; npm test -- --grep bulk-edit)
• C2. Add a Nala test (N/A — backend IO action, no rendered surface)
• C3. Verify all Checks are green (unit tests)
• C4. PR description contains working Test Page link (N/A — backend IO action; manual via endpoint below / requests.http)
• C5. Ready to demo from Test Page (blocked on Studio UI — API ready for integration)
• C.6 Re-read Jira to validate all ACs addressed

Test plan

Endpoint: https://14257-masstudio-yesil.adobeioruntime.net/api/v1/web/MerchAtScaleStudio/bulk-edit-find

Use io/studio/requests.http or curl with MAS_TOKEN from io/studio/.env.

• Start find — POST with { "surface": "sandbox", "find": "firefly", "searchIn": "*", "matchCase": false } → 202 { jobId, reused }
• Poll — GET ?jobId=<jobId> until done: true and exportReady: true; confirm exports.json / exports.csv presigned URLs and per-locale report
• Download exports — follow presigned URLs (no Bearer token); confirm JSON fragments + CSV rows; title hits use Odin field names (e.g. cardTitle, fragmentTitle)
• CSV upload — edit CSV, POST ?jobId=<jobId> (multipart) → poll shows filteredByUpload: true and reduced total
• CSV delete — DELETE ?jobId=<jobId> → filteredByUpload: false, full total restored
• Cache reuse — repeat same POST find params → reused: true; add "forceRefresh": true → worker re-runs, uploads/exports cleared
• Filters — locale, searchIn, tags, status, matchCase (see requests.http)

Test URLs

Bulk-edit find API (yesil workspace): https://14257-masstudio-yesil.adobeioruntime.net/api/v1/web/MerchAtScaleStudio/bulk-edit-find

Requires Authorization: Bearer <mas-studio IMS token>. No rendered test page — exercise via REST Client (io/studio/requests.http) or curl.

[aem-code-sync]

Hello, I'm the AEM Code Sync Bot and I will run some actions to deploy your branch.
In case there are problems, just click the checkbox below to rerun the respective action.

• Re-sync branch

Commits

• 2167293 ✅ (latest)
• 2de91f3 ✅
• b110f64 ✅
• b10938d ✅
• a2f66e2 ✅
• 69a5a08 ✅
• 514676c ✅
• 4299a28 ✅
• c69a232 ✅
• d16f64d ✅
• 4e450b8 ✅
• 9ed8119 ✅
• 4f577ce ✅
• 50b4726 ✅
• f74b562 ✅
• 90d39e8 ✅
• dc70181 ✅
• 1d073ce ✅
• 4605743 ✅
• 1955125 ✅
• 027b081 ✅
• 4144cdc ✅
• ef50cd0 ✅
• 25436b7 ✅
• 4fbee6a ✅
• 67f911f ✅
• b791c84 ✅
• 6f9c461 ✅
• 17f4d2c ✅
• 85fa23b ✅

[github-actions]

SNOW Change Request Transaction ID [IO]: 0000019c1eec85a3-13f8a5e2

[codecov]

Codecov Report

❌ Patch coverage is 96.28713% with 45 lines in your changes missing coverage. Please review.
✅ Project coverage is 89.95%. Comparing base (6261ea6) to head (dda4e3e).
⚠️ Report is 3 commits behind head on main.

Files with missing lines	Patch %	Lines
io/studio/src/bulk-edit/bulk-edit.js	95.52%	23 Missing ⚠️
io/studio/src/bulk-edit/state.js	90.84%	14 Missing ⚠️
io/studio/src/bulk-edit/csv.js	97.17%	8 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #987      +/-   ##
==========================================
+ Coverage   89.59%   89.95%   +0.36%     
==========================================
  Files         273      282       +9     
  Lines       84441    88978    +4537     
==========================================
+ Hits        75653    80042    +4389     
- Misses       8788     8936     +148     

Files with missing lines	Coverage Δ
io/studio/src/bulk-edit/find-worker.js	100.00% <100.00%> (ø)
io/studio/src/bulk-edit/search.js	100.00% <100.00%> (ø)
io/studio/src/bulk-edit/csv.js	97.17% <97.17%> (ø)
io/studio/src/bulk-edit/state.js	90.84% <90.84%> (ø)
io/studio/src/bulk-edit/bulk-edit.js	95.52% <95.52%> (ø)

... and 25 files with indirect coverage changes

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 6261ea6...dda4e3e. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Axelcureno]

nice! runId cancel and CSV formula escaping are clean.

two things:

• search.js has fragmentTitle in SCOPE_FIELDS and matchEverywhere returns title hits — but PR description says title is excluded. stale or accidental?
• patchJob is non-atomic but fine since workers are sequential. tiny race on force-refresh self-heals via runId mismatch. nbd.