frigatebird 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.3.1 - 2026-02-09
+
+### Added
+- Premium-feature live e2e opt-in flag: `--enable-premium-features-e2e`.
+- Live e2e support for dedicated premium account cookies via `--article-cookie-source`.
+- Coverage thresholds in `vitest.config.ts` to enforce release quality gates.
+
+### Changed
+- Live mutation CI now accepts `workflow_dispatch` input `list_name` instead of a repository variable.
+- Premium feature mutation coverage (article publish path) is disabled by default and only runs when explicitly enabled.
+- Article publish automation was updated for current X compose flows (`/compose/articles`, `Write`, and modern composer/title selectors).
+- Live e2e naming now reflects premium-feature scope instead of article-specific semantics.
+
+### Tests
+- Added/updated Playwright client tests for modern article composer fallback behavior.
+- Verified full release gate (`lint`, `build`, `coverage`) and fixture e2e pass on 0.3.1 candidate.
+
 ## 0.3.0 - 2026-02-09
 
 ### Added
@@ -12,7 +29,7 @@
 - Mutation `retweet` flow now uses bounded resilient click handling and explicit completion checks.
 - Read-only fixture e2e was optimized to run significantly faster while preserving command coverage.
 - CI and release verification workflows now include fixture e2e smoke runs.
-- Live mutation e2e now requires `FRIGATEBIRD_LIVE_LIST_NAME` and always validates list `add/remove/batch` paths.
+- Live mutation e2e now requires a `--list-name` argument and always validates list `add/remove/batch` paths.
 
 ### Tests
 - Expanded unit coverage for session identity parsing and retweet mutation branches.

package/README.md

@@ -1,6 +1,9 @@
 # frigatebird 🐦 — resilient X CLI for posting, articles, replies, reading, and list automation
 
-![Frigatebird logo](images/frigatebird_logo.jpeg)
+<div style="text-align: center;">
+  <img src="images/frigatebird_logo.jpg" alt="Frigatebird logo" />
+</div>
+
 
 `frigatebird` is a Playwright-first X CLI that preserves the familiar `bird` command-line experience while running on browser automation instead of private GraphQL internals.
 
@@ -198,21 +201,24 @@ npm run lint
 npm run test:run        # unit/integration
 npm run test:coverage   # unit/integration + coverage
 npm run test:e2e        # e2e only
-npm run test:e2e:live   # opt-in live mutation e2e (requires env vars below)
+npm run test:e2e:live -- --list-name testlist001   # opt-in live mutation e2e (article mutation disabled by default)
 npm run smoke:pack-install
 ```
 
-Live mutation e2e env requirements:
+Live mutation e2e requirements:
+- required argument: `--list-name <your-list-name>`
 - `FRIGATEBIRD_AUTH_TOKEN`
 - `FRIGATEBIRD_CT0`
-- `FRIGATEBIRD_LIVE_LIST_NAME`
-- optional: `FRIGATEBIRD_LIVE_COOKIE_SOURCE`, `FRIGATEBIRD_LIVE_EXPECTED_HANDLE_PREFIX`, `FRIGATEBIRD_LIVE_TARGET_HANDLE`
+- optional args: `--cookie-source <source>`
+- optional env: `FRIGATEBIRD_LIVE_COOKIE_SOURCE`, `FRIGATEBIRD_LIVE_EXPECTED_HANDLE_PREFIX`, `FRIGATEBIRD_LIVE_TARGET_HANDLE`
+- article mutation is disabled by default; enable manually with:
+  - `--enable-premium-features-e2e --article-cookie-source chrome --article-expected-handle-prefix Oceanswave`
 
 ## Release
 
 - CI: `.github/workflows/ci.yml`
 - npm publish: `.github/workflows/release.yml` (triggered by GitHub Release `published`, trusted publishing/OIDC)
-- live mutation CI: `.github/workflows/live-e2e.yml` (manual trigger; validates `FRIGATEBIRD_LIVE_LIST_NAME` + auth secrets before running)
+- live mutation CI: `.github/workflows/live-e2e.yml` (manual trigger; accepts `list_name` workflow input + validates auth secrets before running)
 - release checklist: `RELEASE.md`
 
 ## Notes

package/dist/client/playwright-client.js

@@ -319,6 +319,26 @@ export class PlaywrightXClient {
             throw new Error("Composer text area not found. X may have changed selectors.");
         }
     }
+    async recoverComposerFromHome(page, timeoutMs = 12000) {
+        await page.goto(this.absolute("/home"), {
+            waitUntil: "domcontentloaded",
+        });
+        await this.dismissBlockingLayers(page);
+        const composeSelectors = [
+            '[data-testid="SideNav_NewTweet_Button"]',
+            '[data-testid="FloatingActionButton_Tweet"]',
+            'a[href="/compose/post"]',
+            '[role="button"][aria-label*="Post"]',
+        ];
+        await this.clickFirstVisible(page, composeSelectors, 4000).catch(() => false);
+        try {
+            await this.waitForComposer(page, timeoutMs);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
     async fillComposer(page, text) {
         const composerSelectors = [
             '[data-testid="tweetTextarea_0"]',
@@ -696,7 +716,17 @@ export class PlaywrightXClient {
                 await page.goto(this.absolute("/compose/post"), {
                     waitUntil: "domcontentloaded",
                 });
-                await this.waitForComposer(page, 12000);
+                await this.dismissBlockingLayers(page);
+                let composerReady = true;
+                try {
+                    await this.waitForComposer(page, 12000);
+                }
+                catch {
+                    composerReady = await this.recoverComposerFromHome(page, 12000);
+                }
+                if (!composerReady) {
+                    throw new Error("Composer text area not found. X may have changed selectors.");
+                }
                 await this.fillComposer(page, text);
                 await this.attachMedia(page, mediaSpecs);
                 await this.submitComposer(page, "tweet");
@@ -717,6 +747,7 @@ export class PlaywrightXClient {
         return this.withPage(async (page) => {
             await this.ensureAuth(page);
             const composePaths = [
+                "/compose/articles",
                 "/i/articles/new",
                 "/compose/article",
                 "/write",
@@ -731,19 +762,36 @@ export class PlaywrightXClient {
                 '[role="textbox"][aria-label*="Title"]',
                 'input[placeholder*="Title"]',
                 'textarea[placeholder*="Title"]',
+                'input[placeholder*="title" i]',
+                'textarea[placeholder*="title" i]',
+                'textarea[placeholder*="Add a title"]',
                 '[contenteditable="true"][aria-label*="Title"]',
             ];
             const bodySelectors = [
                 '[data-testid="articleBodyInput"]',
                 '[data-testid="article-editor"] [contenteditable="true"]',
+                '[data-testid="composer"][role="textbox"]',
+                '[data-testid="composer"]',
                 '.ProseMirror[contenteditable="true"]',
                 '[role="textbox"][aria-label*="Write"]',
                 '[contenteditable="true"][aria-label*="Write"]',
                 '[role="textbox"][aria-label*="Body"]',
                 'textarea[placeholder*="Write"]',
             ];
+            const combinedComposerSelectors = [
+                '[data-testid="composer"][role="textbox"]',
+                '[data-testid="composer"]',
+                '[contenteditable="true"][data-testid="composer"]',
+            ];
+            const writeSelectors = [
+                '[data-testid="empty_state_button_text"]:has-text("Write")',
+                '[role="button"]:has-text("Write")',
+                '[role="link"]:has-text("Write")',
+                '[role="button"]:has-text("New article")',
+            ];
             let titleField = null;
             let bodyField = null;
+            let combinedComposer = null;
             for (const path of composePaths) {
                 await page
                     .goto(this.absolute(path), { waitUntil: "domcontentloaded" })
@@ -754,25 +802,54 @@ export class PlaywrightXClient {
                     '[role="button"]:has-text("Write article")',
                     '[data-testid="articleComposerButton"]',
                     'a[href*="/i/articles/new"]',
+                    'a[href*="/compose/articles"]',
+                    '[role="link"]:has-text("Articles")',
                 ], 1500).catch(() => false);
+                await this.clickFirstVisible(page, writeSelectors, 1500).catch(() => false);
                 titleField = await this.firstVisibleLocator(page, titleSelectors, 3500, 120);
                 bodyField = await this.firstVisibleLocator(page, bodySelectors, 3500, 120);
-                if (titleField && bodyField) {
+                combinedComposer = await this.firstVisibleLocator(page, combinedComposerSelectors, 2500, 120);
+                if ((titleField && bodyField) || combinedComposer) {
                     break;
                 }
             }
             if (!titleField || !bodyField) {
-                return fail("Could not locate article composer. Articles may be unavailable for this account or X changed selectors.");
+                if (combinedComposer) {
+                    await combinedComposer.click().catch(() => { });
+                    await combinedComposer.fill(`${cleanTitle}\n\n${cleanBody}`);
+                    const inserted = await combinedComposer
+                        .evaluate((node) => {
+                        const element = node;
+                        return (element.innerText ||
+                            element.textContent ||
+                            element.value ||
+                            "").trim();
+                    })
+                        .catch(() => "");
+                    if (inserted.length < Math.min(8, cleanTitle.length) ||
+                        !inserted
+                            .toLowerCase()
+                            .includes(cleanBody.slice(0, 8).toLowerCase())) {
+                        await page.keyboard
+                            .type(`${cleanTitle}\n\n${cleanBody}`)
+                            .catch(() => { });
+                    }
+                }
+                else {
+                    return fail("Could not locate article composer. Articles may be unavailable for this account or X changed selectors.");
+                }
+            }
+            else {
+                await titleField.click().catch(() => { });
+                await titleField.fill(cleanTitle);
+                await bodyField.click().catch(() => { });
+                await bodyField.fill(cleanBody);
             }
-            await titleField.click().catch(() => { });
-            await titleField.fill(cleanTitle);
-            await bodyField.click().catch(() => { });
-            await bodyField.fill(cleanBody);
             const published = await this.clickFirstVisible(page, [
                 '[data-testid="articlePublishButton"]:not([aria-disabled="true"])',
                 '[data-testid="publishButton"]:not([aria-disabled="true"])',
-                '[role="button"]:has-text("Publish"):not([aria-disabled="true"])',
-                '[role="button"]:has-text("Post"):not([aria-disabled="true"])',
+                '[role="button"]:has-text("Publish"):not([aria-disabled="true"]):not([disabled])',
+                '[role="button"]:has-text("Post"):not([aria-disabled="true"]):not([disabled])',
             ], 12000).catch(() => false);
             if (!published) {
                 return fail("Could not locate article publish button.");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "frigatebird",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "Playwright-first X CLI with bird-style parity and resilient web automation",
 	"type": "module",
 	"main": "./dist/cli.js",
@@ -42,7 +42,7 @@
 		"test:run": "vitest run --config vitest.config.ts",
 		"test:coverage": "vitest run --config vitest.config.ts --coverage",
 		"test:e2e": "vitest run --config vitest.e2e.config.ts",
-		"test:e2e:live": "FRIGATEBIRD_LIVE_E2E=1 vitest run --config vitest.e2e.config.ts tests/e2e/live-mutation-account.e2e.test.ts",
+		"test:e2e:live": "tsx scripts/run-live-e2e.ts",
 		"lint": "biome check .",
 		"lint:fix": "biome check --write .",
 		"release:check": "npm run lint && npm run build && npm run test:coverage",