itamatrix 1.0.2 → 1.0.3

package/dist/browser/forms.js

@@ -24,7 +24,7 @@ export async function driveSearchForm(page, spec) {
  * `solutionList` shape as a normal search (N slices instead of 1–2).
  */
 export async function driveMultiCityForm(page, spec) {
-    await page.getByRole("tab", { name: "Multi-City", exact: true }).click();
+    await page.getByRole("tab", { name: /multi[\s-]?city/i }).click();
     await ensureLegRows(page, spec.slices.length);
     for (const [i, leg] of spec.slices.entries()) {
         await fillAirport(page, 2 * i, leg.origin);
@@ -87,13 +87,16 @@ async function setAdvancedControls(page, spec, roundTrip) {
     }
 }
 /**
- * Adds "Add another flight" rows until the form has `count` legs. Matrix shows
- * two legs by default, so we only click for the extras.
+ * Adds "Add Flight" rows until the form has `count` legs. The default number of
+ * rows Matrix renders has drifted (currently one), so derive it from the live
+ * combobox count (two per leg) rather than assuming a fixed starting point.
  */
 async function ensureLegRows(page, count) {
     const addLeg = page.getByRole("button", { name: /add (another )?flight/i });
-    for (let existing = 2; existing < count; existing++) {
+    const comboboxes = page.getByRole("combobox", { name: "Add airport" });
+    for (let existing = (await comboboxes.count()) / 2; existing < count; existing++) {
         await addLeg.click();
+        await comboboxes.nth(2 * existing + 1).waitFor({ state: "visible", timeout: 15_000 });
     }
 }
 /** Multi-city: shared cabin/stops globally, routing/ext per leg by row index. */

package/docs/ROUTING_CODES.md

@@ -41,6 +41,8 @@ Define which carriers / airports / operators a slice may use, and in what order.
 | `C:XX` | force **marketing** carrier | `C:BA` |
 | `O:XX` | force **operating** carrier | `O:AA` |
 | `X:AAA` | **require** connection at airport | `X:DFW` |
+| `X` | any single connection point | `UA X UA` |
+| `X?` | nonstop **or** one connection | `X?` |
 | `N:` | nonstop only (no connections) | `N:` |
 | `F:` | direct (single flight number, stops allowed) | `F:` |
 
@@ -96,6 +98,9 @@ pipe-(`|`)-separated.
 | No red-eyes | `-REDEYES` | `-REDEYES` | exclude red-eye flights |
 | No overnights | `-OVERNIGHTS` | `-OVERNIGHTS` | exclude overnight layovers |
 | No props | `-PROPS` | `-PROPS` | exclude propeller aircraft |
+| No airport change | `-CHANGE` | `-CHANGE` | exclude connections that change airports in a city |
+| No trains | `-TRAIN` | `-TRAIN` | exclude rail segments |
+| No helicopters | `-HELICOPTER` | `-HELICOPTER` | exclude helicopter segments |
 
 ### Faring codes (`f` / booking class / fare basis)
 
@@ -123,7 +128,27 @@ pipe-(`|`)-separated.
 
 ---
 
-## 3. Notes for the skill
+## 3. Power-user strategies (FlyerTalk / community)
+
+Higher-leverage patterns that combine the primitives above:
+
+- **Force a stopover / overnight.** Matrix has no "stopover" command — fake it with a large
+  minimum connection. `MINCONNECT 12:00` forces an overnight layover; values above `24:00`
+  (e.g. `MINCONNECT 30:00`) force a 24 h+ stopover. Pin *where* with `X:CITY` in Routing.
+  Pair with `MAXCONNECT` to bound it: `X:NRT` + `MINCONNECT 20:00; MAXCONNECT 30:00`.
+- **Split marketing vs operating for mileage credit.** Force the metal you want with `O:` in
+  Routing and the program you want to credit with marketing carrier / `ALLIANCE`. E.g. fly
+  Lufthansa metal but ticket via a partner: Routing `O:LH+`, Extension `ALLIANCE star-alliance`.
+- **Target a booking class for upgrades / earning.** `f bc=...` pins the prime booking code
+  (fare buckets differ in price, upgrade eligibility, and miles earned). `f bc=w|bc=v` allows
+  either. Combine with `+CABIN` to keep the displayed cabin honest.
+- **Mileage-run / distance tuning.** `MINMILES`/`MAXMILES` shape itinerary distance; useful for
+  hitting an elite-qualifying threshold or avoiding wasteful backtracking.
+- **Consider nearby airports.** Matrix's UI accepts comma-separated origins/destinations
+  (e.g. `BOS,PVD,MHT`) and secondary airports are often materially cheaper; if a single-field
+  comma string is rejected, fall back to one search per airport and compare.
+
+## 4. Notes for the skill
 
 - **Validate field placement**: path-shaped intent → Routing; filter/fare intent → Extension.
 - **Cabin two ways**: the top-level `--cabin` (search option) sets the *displayed* cabin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itamatrix",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "CLI for ITA Matrix flight search",
   "type": "module",
   "bin": {

package/skills/itamatrix/SKILL.md

@@ -18,7 +18,9 @@ request into the right command + flags, encoding advanced intent as ITA
 
 The CLI ships as `itamatrix` (`npx itamatrix ...` if not installed globally).
 On first use it may ask for the browser: `npx playwright install chromium`.
-Queries take 30–60 s (Matrix is slow server-side); repeated queries hit the cache.
+Queries can take a while (Matrix is slow server-side); repeated queries hit the
+cache. **Set the command timeout to at least 180 s** — a search may run that long
+before returning. Don't kill it early and conclude it failed.
 
 Always run with `--json` so you get structured output to parse and summarize.
 
@@ -62,6 +64,17 @@ grammar before constructing codes. Rules of thumb:
 - The `f` faring grammar is community-documented, not official — let Matrix
   validate. Don't over-restrict locally.
 
+### High-leverage patterns (see the reference doc's "Power-user strategies")
+
+- **Force a stopover/overnight** — Matrix has no stopover command; fake it with a
+  big minimum connection. "Overnight in Tokyo" → `--routing X:NRT --ext "MINCONNECT 12:00"`;
+  24 h+ stopover → `MINCONNECT 30:00`.
+- **Mileage credit / specific metal** — force operating carrier in `--routing` (`O:LH+`)
+  and the crediting program via `--ext "ALLIANCE star-alliance"`.
+- **Upgrade/earning fare buckets** — pin booking class with `--ext "f bc=w|bc=v"`.
+- **Time format gotcha**: `--ext` uses `h:mm` (`MINCONNECT 12:00`); the inline
+  `--routing / minconnect 720` form uses raw minutes. Prefer `--ext`.
+
 ## Workflow
 
 1. Parse the request: route(s), dates, travelers, and any constraints.
@@ -165,6 +178,13 @@ itamatrix --json multicity \
   --ext "-OVERNIGHTS"
 ```
 
+> "Boston to Singapore in October, but I want a long overnight stopover in Tokyo."
+
+```bash
+itamatrix --json search BOS SIN --depart 2026-10-10 \
+  --routing "X:NRT" --ext "MINCONNECT 12:00; MAXCONNECT 30:00"
+```
+
 > "What's the cheapest week in August to do a 7-night trip BOS→LAX on United?"
 
 ```bash