Repository Public License
1<!--2ORIX OS Automation3File: docs/workflows/examples.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Built-in example automations89The 15 automations of `Workflows/Examples/` ship in the app (template gallery) and are what `orixctl workflow templates`10lists. This page says, for each one, what it does, its parameters, the permissions it declares and the tier of each11step, where its sample data is, how to try it, what it must produce, and its limitations **as observed**.1213Everything below was run on one Mac on **2026-11-21** (macOS 27.0, Mac17,6) by14`Packages/ORIXServices/Tests/ORIXServicesTests/ExamplesEndToEndTests.swift` (suite `Integration · examples`): real services15on a temporary data folder, the real registered tools, the sample data copied into a temporary workspace. "Verified"16means that test passed with assertions on the content of the artifacts; nothing here is claimed beyond that.1718## How to try an example1920Sample data lives in `Workflows/Samples/<slug>/`. The default parameters point at `~/ORIX Samples/<slug>/…`, so copy the21sample there (or pass your own paths as parameters):2223```bash24mkdir -p ~/"ORIX Samples" && cp -R Workflows/Samples/<slug> ~/"ORIX Samples"/25cd Packages/ORIXServices && swift build # builds .build/debug/orixctl26orixctl workflow templates # the 15 slugs27orixctl workflow install <slug> # copies the template into your workflows (same as the gallery)28orixctl workflow run <slug> --dry-run --accept-permissions # simulation: nothing is changed29orixctl workflow run <slug> --accept-permissions --approve all [--param name=json …]30```3132- `--accept-permissions` accepts the permissions the workflow declares for these parameters (what the review sheet of33 the app does). Without it, and without `--approve all`, the first tool call waits: the run ends `WAITING_APPROVAL`34 and nothing happens. Verified for examples 1, 8 and 9 (headless service, nothing accepted: no file written, no35 request sent).36- `--approve all` answers every approval, including the manual gates of examples 1 and 15. With the declared37 permissions accepted **no tool call of any example needs an approval**: the tests refuse every tool approval and38 only answer the manual gates.39- `--data DIR` keeps the run history of your experiments out of the app's data folder.40- In the app: **Workflows › Template gallery**, pick the template, review the parameters and permissions in the run41 sheet, then run (or dry-run) it.4243Things that hold for all examples:4445- **Tiers.** 0 = read-only, 1 = reversible local write, 2 = consequential (processes, scripts, app automation,46 browser input). No example uses a tier 3 tool; none deletes, commits or pushes.47- **Notifications** (examples 3, 7, 8, 9, 10) need the ORIX app: a command-line process has no application bundle, so48 the notification step fails by itself (`Notifications need an application bundle`), it is the last step, and the run49 ends `PARTIALLY_SUCCEEDED` with every artifact produced and verified. This is what the tests observe. A notification50 actually appearing from the app was **not verified** here.51- **Dry runs** execute no tool that lacks a dry-run mode, which includes every read tool. A dry run therefore shows the52 writes it can foresee and reports the rest as "not executed" or "skipped"; examples 8 and 9 end `FAILED` in a dry53 run because their later steps need files the earlier steps would have created. A dry run never writes (verified on54 all 15 with the sample data present).55- **Outputs** (`output:` steps) are available on the live run handle; the stored receipt keeps status, tool calls,56 verifications, artifacts and limitations, not the output values.5758---5960## 1. Smart Downloads Organizer — `smart-downloads-organizer`6162Sorts the files at the top level of a folder into category subfolders chosen from the extension, after a manual63approval. Files are moved, never deleted or overwritten.6465| Parameter | Default | |66|---|---|---|67| `source` | `~/ORIX Samples/smart-downloads-organizer/Downloads` | folder to organise |68| `destination` | `~/ORIX Samples/smart-downloads-organizer/Sorted` | receives one subfolder per category |6970**Permissions:** read `source`, `destination`; write `source` (a move changes the source folder) and `destination`.71**Steps and tiers:** `list`, `remaining` — `filesystem.list` (0); `confirm` — manual gate (shown as consequential);72`makeFolder` — `filesystem.mkdir` (1); `move` — `filesystem.move` (1).7374**Sample:** `Workflows/Samples/smart-downloads-organizer/Downloads` — 11 files of mixed kinds (text, CSV, PDF, PNG, zip,75placeholder audio/video, a file without extension, an upper-case extension) and a `Projects/` subfolder.7677**Expected:** `Sorted/{Documents,Spreadsheets,Images,Archives,Audio,Video,Other}/…` holding the 11 files with unchanged78content; `Downloads/` keeps only `Projects/keep-me.txt`; output `moved: 11`.7980**Verified 2026-11-21:** each file is in its category with the same SHA-256, nothing else was created, nothing was81deleted, the gate was asked once. Headless without accepted permissions: `WAITING_APPROVAL`, tree unchanged.8283**Limitations:** top level only, hidden files ignored, at most 500 entries per run; a name collision in the destination84fails that move and stops the run (files already moved stay moved); category by extension only.8586## 2. PDF to structured data and report — `pdf-to-structured-report`8788Reads every PDF under a folder (page count, title, size of the text layer), writes a CSV catalogue and renders a PDF89report from a Markdown table.9091| Parameter | Default |92|---|---|93| `inputFolder` | `~/ORIX Samples/pdf-to-structured-report/Input` |94| `outputFolder` | `~/ORIX Samples/pdf-to-structured-report/Output` |9596**Permissions:** read both folders; write `outputFolder`.97**Steps and tiers:** `find` — `filesystem.search` (0); `info`, `text` — `documents.pdfInfo`, `documents.pdfText` (0);98`prepare` — `filesystem.mkdir` (1); `catalog` — `documents.csvWrite` (1); `markdown` — `filesystem.write` (1);99`render` — `documents.renderPDF` (1).100101**Sample:** `Input/` — four synthetic PDFs made by `make-sample-pdfs.swift` (CoreGraphics/CoreText): one page with a102title, three pages with a title, one page without a Title property, and `archive/scan-without-text.pdf` (shapes only,103no text layer).104105**Expected:** `Output/catalog.csv` (header + 4 rows: `file,pages,title,textCharacters`), `report.md`, `report.pdf`106(1 page); outputs `documents: 4`, `pages: 6`.107108**Verified 2026-11-21:** page counts equal PDFKit's own count, the untitled PDF has an empty title, the scan has 0109text characters, the report PDF's text contains the table, the input folder is unchanged.110111**Limitations:** no OCR; first 200 000 bytes of text per PDF; at most 100 PDFs per run; a `|` in a title breaks the112Markdown table; encrypted PDFs fail their iteration.113114## 3. Weekly research digest — `weekly-research-digest` (agent)115116On Mondays 09:00 (or manually) the workflow reads the `.md`, `.txt` and `.pdf` files of a folder, hands their text to117an agent as data, and the agent writes a dated digest in Markdown, which is then rendered as PDF.118119| Parameter | Default |120|---|---|121| `researchFolder` | `~/ORIX Samples/weekly-research-digest/Research` |122| `reportsFolder` | `~/ORIX Samples/weekly-research-digest/Reports` |123| `maxDocuments` | `25` |124125**Permissions:** read both folders; write `reportsFolder`; notifications. Budget: US$0.50, 600 000 tokens.126**Steps and tiers:** `discover` — `filesystem.list` (0); `content` — `filesystem.read` per text file (0);127`pdfContent` — `documents.pdfText` per PDF (0); `prepare` — `filesystem.mkdir` (1); `analyze` — agent whose only tool128is `filesystem.write` (1); `readDigest` — `filesystem.read` (0); `render` — `documents.renderPDF` (1); `announce` —129notification (1).130131**Sample:** `Research/` — a short brief (`.md`), interview notes in a subfolder (`.txt`) and a three-page PDF, all132synthetic.133134**Expected:** `Reports/digest-<date>.md` with a "Highlights" section naming its source files, and135`digest-<date>.pdf`; output `documents: 3`.136137**Verified live 2026-11-21** with `anthropic:claude-haiku-5-5` through the development key: digest written with the138required section, cites its source files (text and PDF), reflects their content; PDF readable; research folder139unchanged; the agent made no failing tool call; 10 000–17 000 tokens, **about US$0.002**. Ends140`PARTIALLY_SUCCEEDED` under the test because of the notification (see above). Without a key the test prints141`SKIPPED(no ORIX_DEV_ANTHROPIC_API_KEY)` and verifies only the dry run (the agent step is reported as skipped, no142model call, nothing written).143144**Limitations:** needs a provider key and a default model; the digest is model-written and only its existence and145section are verified, not its accuracy; first 12 000 bytes of each document, no OCR; an unreadable document is left146out and the run ends `PARTIALLY_SUCCEEDED`; listing is 3 levels deep, 500 entries; a scheduled run cannot ask for147approval. An earlier version let the agent open the files itself: in four of five live runs on 2026-11-21 the model148called the PDF reader on a Markdown file (three times before the instructions named the tool per file type, once149after), and because the agent runtime counts a failed tool call that the same tool never repeats successfully as an150unrecovered failure, those runs ended `FAILED` with a digest on disk. That is why the workflow now reads the documents151itself (three live runs in a row passed). The same strictness applies to examples 4 and 11, whose agents still read152files themselves (plain text only; no failure observed in four live runs each).153154## 4. Git repository test-and-review assistant — `git-test-and-review` (agent)155156Reads the status, diff and log of a local repository, runs its test command, has an agent write a review of the157uncommitted changes with the test result in hand, and saves the diff as a patch. It never commits or pushes.158159| Parameter | Default | |160|---|---|---|161| `repository` | `~/ORIX Samples/git-test-and-review/repo` | working tree |162| `testExecutable` | `sh` | the program that runs the tests; it is the declared process permission |163| `testArguments` | `[run-tests.sh]` | argv array, no shell |164| `reviewsFolder` | `~/ORIX Samples/git-test-and-review/Reviews` | receives `review.md`, `changes.patch` |165166**Permissions:** read `repository`, `reviewsFolder`; write `reviewsFolder`; processes `git` and `testExecutable`.167Budget: US$0.50.168**Steps and tiers:** `status`, `diff`, `log`, `patch` — `git.status`, `git.diff`, `git.log`, `git.createPatch` (0;169the patch is written to the run's artifacts); `tests` — `shell.run` (2, sandboxed); `prepare` — `filesystem.mkdir`170(1); `review` — agent limited to `filesystem.read`, `filesystem.search`, `git.diff`, `git.log` (0) and171`filesystem.write` (1); `savePatch` — `filesystem.copy` (1).172173**Sample:** `Workflows/Samples/git-test-and-review/setup.sh [target]` creates `<target>/repo` (default174`~/ORIX Samples/git-test-and-review/repo`): two commits on `main`, then an uncommitted change that breaks its three175shell tests, plus one untracked file. No nested `.git` is stored in this repository.176177```bash178Workflows/Samples/git-test-and-review/setup.sh179orixctl workflow run git-test-and-review --accept-permissions --approve all180```181182**Expected:** `Reviews/review.md` (sections Tests / Must fix / Should fix / Notes, stating that the tests failed),183`Reviews/changes.patch`; outputs `testsPassed: false`, `branch: main`, `patchWritten: true`.184185**Verified live 2026-11-21** (Haiku 5.5): the review states the failure and discusses `slugify.sh`; the patch holds the186tracked change and not the untracked file; `HEAD`, commit count and `git status --porcelain` are identical before and187after; about 13 000–20 000 tokens, **US$0.002**; `SUCCEEDED`. Without a key: `SKIPPED(no ORIX_DEV_ANTHROPIC_API_KEY)`188for the review, but the git steps, the real test command (exit code 1, its output) and the patch are still verified,189and the run ends `FAILED` at the agent step, with no review file.190191**Limitations:** the test command is sandboxed — it reads the repository but can only write to the reviews folder and192the run's artifacts, so runners that write build products into the repository (`swift test`, `npm test`) need the193repository added to `permissions.filesystem.write` by the user; a non-zero exit code does not fail the step (it is194reported); the patch has unstaged changes of tracked files only; needs a provider key.195196## 5. CSV cleanup and chart generation — `csv-cleanup-and-charts`197198Cleans a CSV with a standard-library Python script running in the sandbox, and draws an SVG bar chart of the first199all-numeric column.200201| Parameter | Default |202|---|---|203| `inputFile` | `~/ORIX Samples/csv-cleanup-and-charts/input.csv` |204| `outputFolder` | `~/ORIX Samples/csv-cleanup-and-charts/Output` |205206**Permissions:** read `inputFile`, `outputFolder`; write `outputFolder`; script runtime `python`.207**Steps and tiers:** `inspect`, `cleaned` — `documents.csvRead` (0); `prepare` — `filesystem.mkdir` (1); `clean` —208`python.run` (2, sandboxed, no network).209210**Sample:** `input.csv` — byte-order mark, padded cells, a blank line, an all-empty row, two duplicate rows, a short211row and a row with an extra cell.212213**Expected:** `Output/cleaned.csv` (header + 5 rows: North, South, East, West, Central) and `Output/chart.svg` (five214bars of the `units` column); outputs `rowsBefore: 9`, `rows: 5`.215216**Verified 2026-11-21:** the cleaned file equals the expected text exactly, the chart has 5 bars titled `units`, the217input is unchanged, the output folder contains only the two files.218219**Limitations:** needs a `python3` on the Mac (ORIX creates its own virtual environment from it on first use, a few220seconds; system Python is never modified); UTF-8 input only; first 40 rows charted; cleaning is trimming, padding and221exact de-duplication, nothing smarter.222223## 6. Batch image conversion and naming — `batch-image-conversion`224225Converts every image at the top level of a folder to one format with sequential names, four at a time. Originals are226untouched.227228| Parameter | Default |229|---|---|230| `sourceFolder` | `~/ORIX Samples/batch-image-conversion/Originals` |231| `outputFolder` | `~/ORIX Samples/batch-image-conversion/Converted` |232| `format` | `jpeg` (png, jpeg, jpg, heic, tiff, gif, bmp) |233| `prefix` | `image` |234235**Permissions:** read both folders; write `outputFolder`.236**Steps and tiers:** `list`, `converted` — `filesystem.list` (0); `prepare` — `filesystem.mkdir` (1); `one` —237`documents.imageConvert` (1).238239**Sample:** `Originals/` — five synthetic images made by `make-sample-images.swift` (PNG with alpha, JPEG, TIFF, GIF,240a PNG with an upper-case extension and a space in its name) and one text file that must be ignored.241242**Expected:** `Converted/<prefix>-1.jpeg … <prefix>-5.jpeg`; output `converted: 5`.243244**Verified 2026-11-21:** five readable JPEGs with the pixel sizes of their sources, in listing order; the text file is245left out; originals unchanged.246247**Limitations:** names follow byte order (upper case first) and are not zero-padded; an existing output file is never248overwritten (a rerun into a non-empty folder fails on the first collision); animated GIFs keep their first frame only.249250## 7. Calendar-based preparation — `calendar-preparation` (Apple Events)251252On weekday mornings (or manually) reads the start date and title of the coming events from Calendar with one253AppleScript and writes a briefing with a checklist line per event. Read-only.254255| Parameter | Default |256|---|---|257| `daysAhead` | `1` |258| `outputFolder` | `~/ORIX Samples/calendar-preparation/Briefings` |259260**Permissions:** write `outputFolder`; script runtime `applescript`; automation of `com.apple.iCal`; notifications.261**Steps and tiers:** `prepare` — `filesystem.mkdir` (1); `events` — `applescript.run` targeting Calendar (2);262`write` — `filesystem.write` (1); `announce` — notification (1).263264**Sample:** none needed (the workflow reads the real Calendar). `sample-events.ics` holds two synthetic events you can265import into a calendar to try it on known data; see `ABOUT.txt`.266267**Expected:** `Briefings/briefing-<date>.md` — "Events in the next N day(s): k" and k checklist lines.268269**Status 2026-11-21: SKIPPED(appleEvents not granted).** Calendar was not running and Automation consent for it had270never been given to the test process, so its status was `unknown`; running the script would have made macOS show its271consent prompt, which a test must not do. Verified instead: the script addresses only Calendar and contains no command272that creates, changes or deletes anything; the declared permissions are the Calendar automation and one write folder;273a dry run reports the AppleScript step as simulated and writes nothing. The test runs the workflow for real when274consent is already granted (and asserts the briefing), and asserts `BLOCKED_PERMISSION` with no file when consent was275refused. **A real read of Calendar events has not been verified on this Mac.**276277**Limitations:** macOS asks once for Automation consent (ORIX → Calendar) and ORIX never answers it; the script opens278Calendar if it is closed; only start date and title are read; dates are formatted in the Mac's language; large279calendars are slow (120 s limit).280281## 8. Folder backup and verification — `folder-backup-and-verify`282283Archives a folder into a dated zip, records its SHA-256, restores the archive into a temporary folder, compares the284restored tree with the source (hidden files included) and moves the temporary copy to the Trash.285286| Parameter | Default |287|---|---|288| `source` | `~/ORIX Samples/folder-backup-and-verify/Documents` |289| `backupRoot` | `~/ORIX Samples/folder-backup-and-verify/Backups` |290291**Permissions:** read `source`, `backupRoot`; write `backupRoot`; delete (move to Trash) under `backupRoot`;292notifications.293**Steps and tiers:** `prepare` — `filesystem.mkdir` (1); `archive` — `filesystem.archive` (1); `checksum` —294`filesystem.checksum` (0); `record` — `filesystem.write` (1); `restore` — `filesystem.unarchive` (1); `compare` —295`filesystem.compare` (0); `cleanup` — `filesystem.trash` (1); `announce` — notification (1).296297**Sample:** `Documents/` — a small tree with subfolders, a file with accented characters, a 4 kB binary file and a298hidden file.299300**Expected:** `Backups/backup-<date>.zip` and `backup-<date>.zip.sha256`; outputs `identical: true`, `sha256`.301302**Verified 2026-11-21:** the recorded checksum equals the SHA-256 of the archive; an independent `ditto` restore of303the archive gives a tree identical to the source, hidden file included; the source is unchanged; the temporary restore304folder is gone from the backup root and is in the Trash (the test then removes its own item from the Trash). Headless305without accepted permissions: `WAITING_APPROVAL`, nothing written.306307**Limitations:** a local copy, not an off-site backup; needs space for archive + restored copy; one archive per day308(a second run replaces it); old backups are never pruned; the temporary copy stays in the Trash until emptied.309310## 9. Website change monitoring — `website-change-monitor`311312Every hour (or manually) fetches one page from one approved host, keeps the last copy, compares the new body with the313previous one byte for byte and posts a notification when it differs.314315| Parameter | Default | |316|---|---|---|317| `host` | `example.com` | the only host that may be contacted: it **is** the network permission |318| `url` | `https://${{ params.host }}/` | page to watch, on that host |319| `stateFolder` | `~/ORIX Samples/website-change-monitor/State` | keeps `current.html`, `previous.html` |320321**Permissions:** network `host`; read/write `stateFolder`; notifications.322**Steps and tiers:** `fetch` — `http.request` GET (0, network capability); `prepare` — `filesystem.mkdir` (1);323`saveCurrent` — `filesystem.write` (1); `findPrevious` — `filesystem.search` (0); `diff` — `filesystem.compare` (0);324`promote` — `filesystem.copy` (1); `alert` — notification (1).325326**Sample:** `site/page-v1.html` and `site/page-v2.html` (one sentence differs). Serve one on loopback and swap it:327328```bash329cd Workflows/Samples/website-change-monitor/site && cp page-v1.html page.html && python3 -m http.server 8766 --bind 127.0.0.1 &330orixctl workflow run website-change-monitor --accept-permissions --approve all \331 --param host='"127.0.0.1"' --param url='"http://127.0.0.1:8766/page.html"' # first run: baseline332cp page-v2.html page.html # then run again: changed333```334335**Expected:** outputs `firstRun`, `changed`, `status: 200`, `sha256` of the saved body; `previous.html` always holds336the last fetched copy.337338**Verified 2026-11-21 against a loopback server only** (no request to the public internet): baseline run339(`firstRun: true`), identical run (`changed: false`, alert skipped), changed run (`changed: true`, new copy promoted,340alert attempted); exactly one GET per run; the proposed network grant is the `host` parameter; a `url` on another341host than `host` is not fetched (`WAITING_APPROVAL`, no request received); headless without accepted permissions: no342request, nothing written. **The default `https://example.com/` was not contacted by any test.**343344**Limitations:** HTTPS only, plain http for loopback addresses only; one GET, no login, no JavaScript; byte comparison345(rotating content counts as a change), bodies over 2 MB are truncated first; respect the site's terms and robots346policy; the alert is a notification (app only).347348## 10. Local system health report — `system-health-report`349350Collects system information, mounted volumes, the ten busiest processes, power state and network state in parallel,351writes a dated Markdown report and warns when the startup disk is nearly full.352353| Parameter | Default |354|---|---|355| `outputFolder` | `~/ORIX Samples/system-health-report/Reports` |356| `minFreeFraction` | `0.1` |357358**Permissions:** read/write `outputFolder`; notifications.359**Steps and tiers:** `info`, `disk`, `processes`, `power`, `network` — `system.info`, `system.diskUsage`,360`system.processes`, `system.powerState`, `system.networkState` (0, no capability); `prepare` — `filesystem.mkdir` (1);361`write` — `filesystem.write` (1); `warn` — notification (1), only when the disk is low.362363**Sample:** none needed; see `ABOUT.txt`.364365**Expected:** `Reports/health-<date>.md` with the sections Machine, Disk, Busiest processes, Power, Network; outputs366`freeFraction`, `lowDisk`, `osVersion`.367368**Verified 2026-11-21:** the report holds this Mac's real core count and the expected fields; the free fraction is369within 5 points of the figure read directly from the system; only the report file was written; `SUCCEEDED` (the disk370was not low, so the warning was skipped).371372**Limitations:** a snapshot, not a trend; "free" is the space macOS reports as available for important usage (what373Finder shows); sections are raw JSON; the low-disk warning is a notification (app only) and was not exercised; a dry374run has no disk figures and reports the later steps as skipped.375376## 11. Meeting notes organization — `meeting-notes-organizer` (agent)377378For each `.txt`/`.md` transcript of a folder an agent writes a notes file (Summary, Decisions, Action items); the379workflow then writes an index of all notes.380381| Parameter | Default |382|---|---|383| `transcriptsFolder` | `~/ORIX Samples/meeting-notes-organizer/Transcripts` |384| `notesFolder` | `~/ORIX Samples/meeting-notes-organizer/Notes` |385386**Permissions:** read both folders; write `notesFolder`. Budget: US$1 for the whole run.387**Steps and tiers:** `list` — `filesystem.list` (0); `prepare` — `filesystem.mkdir` (1); `summarize` — one agent per388transcript, limited to `filesystem.read` (0) and `filesystem.write` (1); `index` — `filesystem.write` (1).389390**Sample:** `Transcripts/` — two short synthetic meetings (`.txt` and `.md`).391392**Expected:** `Notes/<transcript>-notes.md` per transcript, each with the three sections, and `Notes/index.md` linking393them.394395**Verified live 2026-11-21** (Haiku 5.5): two notes files with the three sections, decisions and owners taken from the396transcripts, index listing both, transcripts unchanged; about 43 000 tokens, **US$0.004**; `SUCCEEDED`. Without a397key: `SKIPPED(no ORIX_DEV_ANTHROPIC_API_KEY)`; the dry run is verified (no model call, nothing written — a dry run398cannot know the transcripts, so the loop is not entered).399400**Limitations:** notes are model-written, only their sections are verified; one agent run per transcript, sequential;401when the cost budget is reached the run stops with `BUDGET_EXCEEDED` and the notes already written stay; top level402only, 500 entries.403404## 12. Document metadata extraction and cataloging — `document-metadata-catalog`405406Walks a folder and writes one CSV row per file: relative path, extension, size, modification date, content type and407SHA-256.408409| Parameter | Default |410|---|---|411| `documentsFolder` | `~/ORIX Samples/document-metadata-catalog/Documents` |412| `catalogFile` | `~/ORIX Samples/document-metadata-catalog/catalog.csv` |413414**Permissions:** read `documentsFolder`, `catalogFile`; write `catalogFile`.415**Steps and tiers:** `list` — `filesystem.list` (0); `meta`, `hash` — `filesystem.metadata`, `filesystem.checksum`416(0); `catalog` — `documents.csvWrite` (1); `readBack` — `documents.csvRead` (0).417418**Sample:** `Documents/` — five small files in nested folders.419420**Expected:** `catalog.csv` with the header `path,extension,bytes,modified,contentType,sha256` and 5 rows; outputs421`files: 5`, `totalBytes`.422423**Verified 2026-11-21:** every row's size and SHA-256 equal the file's, dates are ISO 8601, the row set equals the424file set, the documents are unchanged.425426**Limitations:** file-system metadata only (no PDF author, no EXIF); 16 levels deep, hidden files and symbolic links427skipped; at most 2 000 files — a larger folder fails the verification instead of producing an incomplete catalogue;428the catalogue is rewritten in full at every run.429430## 13. Scheduled screenshot of a selected app window — `scheduled-window-screenshot` (Screen Recording)431432On weekdays every hour (or manually) captures the frontmost window of one chosen application into a dated PNG, when433that application has a window on screen.434435| Parameter | Default |436|---|---|437| `bundleID` | `com.apple.Safari` |438| `outputFolder` | `~/ORIX Samples/scheduled-window-screenshot/Captures` |439440**Permissions:** screen capture scope `window:<bundleID>` (one application's window, never the display); read/write441`outputFolder`.442**Steps and tiers:** `windows` — `system.windows` (0); `prepare` — `filesystem.mkdir` (1); `capture` —443`screen.capture` (1, needs the macOS Screen Recording permission).444445**Sample:** none needed; see `ABOUT.txt`. Try it on a harmless window:446`orixctl workflow run scheduled-window-screenshot --accept-permissions --param bundleID='"com.apple.finder"'`.447448**Expected:** `Captures/capture-<date>-<timestamp>.png`; outputs `captured`, `file`, `windows`.449450**Verified 2026-11-21: VERIFIED(screenRecording granted)** — Screen Recording was already granted to the process that451ran the tests; a real window was captured (a 1720×998 px Terminal window in one run), the PNG was readable with the452pixel size the tool reported, and it was deleted right after the assertion. Also verified: an application that is not453running gives `SUCCEEDED` with `captured: false`, no picture, nothing launched. When Screen Recording is not granted454the test asserts `BLOCKED_PERMISSION` with no file and prints `SKIPPED(screenRecording not granted)`; that branch did455not run on this Mac.456457**Limitations:** ORIX cannot grant itself Screen Recording; the window is captured as displayed (choose the458application with care; password managers are refused by the tool and nothing is captured while a password field has459focus); a locked or sleeping Mac yields nothing; captures are never pruned; the hourly schedule itself was not460exercised here (the scheduler is tested elsewhere).461462## 14. Automated spreadsheet validation — `spreadsheet-validation`463464Reads one sheet of an `.xlsx` workbook, checks that the required columns exist, that no row is empty and that the key465column is always filled, writes a report, and fails the run when a rule is broken.466467| Parameter | Default | |468|---|---|---|469| `workbook` | `~/ORIX Samples/spreadsheet-validation/data.xlsx` | |470| `sheet` | `"1"` | sheet name, or position starting at 1 |471| `requiredColumns` | `[id, name, amount]` | titles expected in the first row |472| `keyColumn` | `0` | zero-based index of the column that must never be empty |473| `reportFolder` | `~/ORIX Samples/spreadsheet-validation/Reports` | receives `validation.md` |474475**Permissions:** read `workbook`, `reportFolder`; write `reportFolder`.476**Steps and tiers:** `read` — `documents.xlsxRead` (0); `prepare` — `filesystem.mkdir` (1); `report` —477`filesystem.write` (1).478479**Sample:** `data.xlsx` (header + 4 complete rows, one formula cell) and `data-invalid.xlsx` (a renamed column, a row480without id, an empty row), both generated by `make-sample-workbooks.sh` from hand-written SpreadsheetML.481482```bash483orixctl workflow run spreadsheet-validation --accept-permissions \484 --param workbook='"~/ORIX Samples/spreadsheet-validation/data-invalid.xlsx"' # ends FAILED, on purpose485```486487**Expected:** `Reports/validation.md` ending with `Valid: true` (run `SUCCEEDED`) or `Valid: false` with the counts488(run `FAILED`).489490**Verified 2026-11-21:** the valid workbook passes with 4 data rows and the formula read as its cached value; the491broken one ends `FAILED` at the verification with the report saying "Missing required columns: 1 amount", "Fully empty492rows: 1", "Rows without a key value: 2"; neither workbook is modified.493494**Limitations:** `.xlsx` only (no `.xls`, `.numbers`, encrypted files); formulas as cached values, dates as serial495numbers; first row is the header; at most 20 000 rows (a longer sheet fails validation); no type or range rules.496497## 15. Multi-step browser data entry on a test site — `browser-data-entry`498499Opens a two-page test form in the built-in browser (a private WKWebView), fills name and e-mail, goes to the second500page, chooses a plan and ticks the terms, asks for approval, submits, reads the confirmation and saves a screenshot.501502| Parameter | Default | |503|---|---|---|504| `host` | `localhost` | the only host the browser may open: it **is** the browser permission |505| `pageURL` | `http://${{ params.host }}:8765/form.html` | first page of the form |506| `fullName`, `email`, `plan` | `Ada Lovelace`, `ada@example.com`, `team` | values entered |507| `evidenceFolder` | `~/ORIX Samples/browser-data-entry/Evidence` | receives `confirmation.png` |508509**Permissions:** browser `host`; read/write `evidenceFolder`.510**Steps and tiers:** `open` — `browser.open` (1); `formReady`, `detailsReady`, `confirmation` — `browser.waitFor` (0);511`fillName`, `fillEmail`, `choosePlan`, `acceptTerms` — `browser.fill` (2); `next`, `submit` — `browser.click` (2);512`confirm` — manual gate before the submission; `readResult` — `browser.read` (0); `screenshot` —513`browser.screenshot` (1); `close` — `browser.close` (0); `prepare` — `filesystem.mkdir` (1).514515**Sample:** `site/` — a static three-page site (`form.html` → `details.html` → `done.html`); the values travel in the516address, nothing is stored or sent anywhere.517518```bash519cd ~/"ORIX Samples"/browser-data-entry/site && python3 -m http.server 8765 --bind 127.0.0.1 &520orixctl workflow run browser-data-entry --accept-permissions --approve all521```522523**Expected:** `Evidence/confirmation.png`; output `confirmation` containing524`Registered <name> <<email>> on plan <plan>.`.525526**Verified 2026-11-21** against a loopback server through the real WKWebView tools: the server received527`/form.html`, then `/details.html?name=…&email=…`, then `/done.html?…plan=…&terms=yes`; the confirmation text shows528the submitted values; the screenshot is a readable PNG whose SHA-256 equals the tool's; the gate was asked once and529named what would be submitted; the browser session is closed at the end. With the gate refused: run `FAILED`, the530second page was reached but `/done.html` was never requested, no screenshot.531532**Limitations:** a test site only — do not point it at a real site without reading its terms; no CAPTCHA, login or533anti-bot measure is handled; the selectors match the sample pages; plain http is accepted for loopback only; the534built-in browser shares nothing with Safari.535536---537538## What was and was not verified, in one table539540| # | Example | 2026-11-21 on this Mac |541|---|---|---|542| 1 | smart-downloads-organizer | verified (real run) + refused without permissions |543| 2 | pdf-to-structured-report | verified (real run) |544| 3 | weekly-research-digest | verified **live** (Haiku 5.5, US$0.002); notification step fails outside the app |545| 4 | git-test-and-review | verified **live** (Haiku 5.5, US$0.002) |546| 5 | csv-cleanup-and-charts | verified (real sandboxed Python) |547| 6 | batch-image-conversion | verified (real run) |548| 7 | calendar-preparation | **skipped**: Automation consent for Calendar not granted; read-only structure and dry run verified |549| 8 | folder-backup-and-verify | verified (real run) + refused without permissions; notification step fails outside the app |550| 9 | website-change-monitor | verified on loopback only + refused without permissions; public internet never contacted |551| 10 | system-health-report | verified (real run); low-disk warning not exercised |552| 11 | meeting-notes-organizer | verified **live** (Haiku 5.5, US$0.004) |553| 12 | document-metadata-catalog | verified (real run) |554| 13 | scheduled-window-screenshot | verified (Screen Recording granted, real window captured and deleted) |555| 14 | spreadsheet-validation | verified (valid and invalid workbook) |556| 15 | browser-data-entry | verified (real WKWebView, loopback site) + refused gate |557558Not verified anywhere: notifications appearing from the app; the triggers firing (schedule, interval, file change —559the scheduler has its own tests); a run started from the app's gallery UI (the gallery calls the same560`installBuiltIn` / `startRun` services the tests use).561562To repeat the verification:563564```bash565cd Packages/ORIXServices566swift test --filter "Integration · examples" # agent examples: dry run only567../../Scripts/test/with-dev-keys.sh swift test --filter "Integration · examples" # agent examples live (under US$0.01 in total)568```569