browser-debugger-cli 0.6.10 → 0.7.0

package/dist/utils/__tests__/shellDetection.unit.test.js

@@ -0,0 +1,220 @@
+/**
+ * Shell Detection Unit Tests
+ *
+ * Tests shell quote damage detection for selectors and scripts.
+ *
+ * Following testing philosophy:
+ * - Test the BEHAVIOR: "Detects damaged input, provides actionable suggestions"
+ * - Test the PROPERTY: "Never throws, always returns valid result"
+ * - No mocking needed - pure utility functions
+ */
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { detectSelectorQuoteDamage, detectScriptQuoteDamage, hasAttributeSelector, } from '../../utils/shellDetection.js';
+void describe('Shell Detection Utilities', () => {
+    void describe('hasAttributeSelector()', () => {
+        void it('returns true for attribute selectors', () => {
+            assert.equal(hasAttributeSelector('[data-test=value]'), true);
+            assert.equal(hasAttributeSelector('[type=submit]'), true);
+            assert.equal(hasAttributeSelector('input[name=email]'), true);
+        });
+        void it('returns false for simple selectors', () => {
+            assert.equal(hasAttributeSelector('#id'), false);
+            assert.equal(hasAttributeSelector('.class'), false);
+            assert.equal(hasAttributeSelector('button'), false);
+            assert.equal(hasAttributeSelector('div.class#id'), false);
+        });
+        void it('returns true for quoted attribute selectors', () => {
+            assert.equal(hasAttributeSelector('[data-test="value"]'), true);
+            assert.equal(hasAttributeSelector("[type='submit']"), true);
+        });
+    });
+    void describe('detectSelectorQuoteDamage()', () => {
+        void describe('detects damaged selectors', () => {
+            void it('detects unquoted attribute value', () => {
+                const result = detectSelectorQuoteDamage('[data-test=value]');
+                assert.equal(result.damaged, true);
+                assert.equal(result.type, 'attribute-selector');
+                assert.ok(result.details?.includes('data-test'));
+                assert.ok(result.details?.includes('value'));
+                assert.ok(result.suggestion?.includes('bdg dom query'));
+            });
+            void it('detects unquoted type attribute', () => {
+                const result = detectSelectorQuoteDamage('[type=submit]');
+                assert.equal(result.damaged, true);
+                assert.ok(result.details?.includes('type'));
+                assert.ok(result.details?.includes('submit'));
+            });
+            void it('detects nested selector with unquoted attribute', () => {
+                const result = detectSelectorQuoteDamage('form [name=email]');
+                assert.equal(result.damaged, true);
+                assert.ok(result.details?.includes('name'));
+            });
+        });
+        void describe('accepts valid selectors', () => {
+            void it('accepts properly quoted double quotes', () => {
+                const result = detectSelectorQuoteDamage('[data-test="value"]');
+                assert.equal(result.damaged, false);
+            });
+            void it('accepts properly quoted single quotes', () => {
+                const result = detectSelectorQuoteDamage("[data-test='value']");
+                assert.equal(result.damaged, false);
+            });
+            void it('accepts simple selectors without attributes', () => {
+                assert.equal(detectSelectorQuoteDamage('#id').damaged, false);
+                assert.equal(detectSelectorQuoteDamage('.class').damaged, false);
+                assert.equal(detectSelectorQuoteDamage('button').damaged, false);
+                assert.equal(detectSelectorQuoteDamage('div > p').damaged, false);
+            });
+            void it('accepts empty selector', () => {
+                const result = detectSelectorQuoteDamage('');
+                assert.equal(result.damaged, false);
+            });
+        });
+        void describe('suggestion quality', () => {
+            void it('provides two-step discovery path', () => {
+                const result = detectSelectorQuoteDamage('[data-test=value]');
+                assert.ok(result.suggestion?.includes('bdg dom query'));
+                assert.ok(result.suggestion?.includes('bdg dom a11y describe 0'));
+            });
+            void it('includes original selector in suggestion', () => {
+                const selector = '[custom-attr=myvalue]';
+                const result = detectSelectorQuoteDamage(selector);
+                assert.ok(result.suggestion?.includes(selector));
+            });
+        });
+    });
+    void describe('detectScriptQuoteDamage()', () => {
+        void describe('detects bare function arguments', () => {
+            void it('detects querySelector with bare argument', () => {
+                const result = detectScriptQuoteDamage('document.querySelector(input)');
+                assert.equal(result.damaged, true);
+                assert.equal(result.type, 'unquoted-argument');
+                assert.ok(result.details?.includes('querySelector'));
+                assert.ok(result.details?.includes('input'));
+            });
+            void it('detects getElementById with bare argument', () => {
+                const result = detectScriptQuoteDamage('document.getElementById(myId)');
+                assert.equal(result.damaged, true);
+                assert.ok(result.details?.includes('getElementById'));
+                assert.ok(result.details?.includes('myId'));
+            });
+            void it('detects closest with bare argument', () => {
+                const result = detectScriptQuoteDamage('element.closest(div)');
+                assert.equal(result.damaged, true);
+                assert.ok(result.details?.includes('closest'));
+                assert.ok(result.details?.includes('div'));
+            });
+            void it('detects getAttribute with bare argument', () => {
+                const result = detectScriptQuoteDamage('el.getAttribute(href)');
+                assert.equal(result.damaged, true);
+                assert.ok(result.details?.includes('getAttribute'));
+                assert.ok(result.details?.includes('href'));
+            });
+            void it('detects classList.add with bare argument', () => {
+                const result = detectScriptQuoteDamage('el.classList.add(active)');
+                assert.equal(result.damaged, true);
+                assert.ok(result.details?.includes('add'));
+                assert.ok(result.details?.includes('active'));
+            });
+            void it('detects matches with bare argument', () => {
+                const result = detectScriptQuoteDamage('element.matches(button)');
+                assert.equal(result.damaged, true);
+                assert.ok(result.details?.includes('matches'));
+            });
+        });
+        void describe('accepts valid scripts', () => {
+            void it('accepts properly quoted strings', () => {
+                assert.equal(detectScriptQuoteDamage('document.querySelector("input")').damaged, false);
+                assert.equal(detectScriptQuoteDamage("document.querySelector('input')").damaged, false);
+                assert.equal(detectScriptQuoteDamage('el.getAttribute("href")').damaged, false);
+            });
+            void it('accepts scripts without function calls', () => {
+                assert.equal(detectScriptQuoteDamage('document.title').damaged, false);
+                assert.equal(detectScriptQuoteDamage('window.location.href').damaged, false);
+                assert.equal(detectScriptQuoteDamage('1 + 2').damaged, false);
+            });
+            void it('accepts numeric arguments', () => {
+                assert.equal(detectScriptQuoteDamage('array.slice(0, 5)').damaged, false);
+                assert.equal(detectScriptQuoteDamage('Math.max(1, 2, 3)').damaged, false);
+            });
+            void it('accepts empty script', () => {
+                const result = detectScriptQuoteDamage('');
+                assert.equal(result.damaged, false);
+            });
+        });
+        void describe('suggestion quality', () => {
+            void it('provides corrected full expression', () => {
+                const result = detectScriptQuoteDamage('document.querySelector(input).value');
+                assert.ok(result.suggestion?.includes('document.querySelector("input").value'));
+            });
+            void it('preserves context around damaged part', () => {
+                const result = detectScriptQuoteDamage('element.closest(div).textContent');
+                assert.ok(result.suggestion?.includes('element.closest("div").textContent'));
+            });
+            void it('includes bdg dom eval command', () => {
+                const result = detectScriptQuoteDamage('func(arg)');
+                assert.ok(result.suggestion?.includes('bdg dom eval'));
+            });
+        });
+        void describe('unexpected identifier fallback', () => {
+            void it('detects unexpected identifier error pattern', () => {
+                const result = detectScriptQuoteDamage("Unexpected identifier 'foo'");
+                assert.equal(result.damaged, true);
+                assert.ok(result.suggestion?.includes('single quotes'));
+            });
+        });
+    });
+    void describe('Type safety and edge cases', () => {
+        void it('never throws for any string input', () => {
+            const edgeCases = [
+                '',
+                ' ',
+                '[]',
+                '()',
+                '[=]',
+                'func()',
+                '[[nested]]',
+                'a'.repeat(1000),
+                '🚀',
+                '\n\t',
+                'null',
+                'undefined',
+            ];
+            for (const input of edgeCases) {
+                assert.doesNotThrow(() => {
+                    detectSelectorQuoteDamage(input);
+                    detectScriptQuoteDamage(input);
+                    hasAttributeSelector(input);
+                }, `Should not throw for input: ${JSON.stringify(input)}`);
+            }
+        });
+        void it('always returns valid ShellDamageResult structure', () => {
+            const inputs = ['[test=value]', '#simple', 'func(arg)', 'valid()'];
+            for (const input of inputs) {
+                const selectorResult = detectSelectorQuoteDamage(input);
+                const scriptResult = detectScriptQuoteDamage(input);
+                assert.equal(typeof selectorResult.damaged, 'boolean');
+                assert.equal(typeof scriptResult.damaged, 'boolean');
+                if (selectorResult.damaged) {
+                    assert.equal(typeof selectorResult.details, 'string');
+                    assert.equal(typeof selectorResult.suggestion, 'string');
+                }
+                if (scriptResult.damaged) {
+                    assert.equal(typeof scriptResult.details, 'string');
+                    assert.equal(typeof scriptResult.suggestion, 'string');
+                }
+            }
+        });
+        void it('handles special regex characters safely', () => {
+            const specialChars = ['[test.value]', '[test*=value]', '[test^=value]', 'func(a|b)'];
+            for (const input of specialChars) {
+                assert.doesNotThrow(() => {
+                    detectSelectorQuoteDamage(input);
+                    detectScriptQuoteDamage(input);
+                });
+            }
+        });
+    });
+});
+//# sourceMappingURL=shellDetection.unit.test.js.map

package/dist/utils/__tests__/shellDetection.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellDetection.unit.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/shellDetection.unit.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/async.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Async utilities for common patterns.
+ */
+/**
+ * Delay execution for a specified duration.
+ *
+ * @param ms - Milliseconds to delay
+ */
+export declare function delay(ms: number): Promise<void>;
+//# sourceMappingURL=async.d.ts.map

package/dist/utils/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/utils/async.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/async.js

@@ -0,0 +1,12 @@
+/**
+ * Async utilities for common patterns.
+ */
+/**
+ * Delay execution for a specified duration.
+ *
+ * @param ms - Milliseconds to delay
+ */
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=async.js.map

package/dist/utils/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../../src/utils/async.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/utils/atomicFile.js

@@ -1,7 +1,7 @@
 import * as crypto from 'crypto';
 import * as fs from 'fs';
-import { getErrorMessage } from '../connection/errors.js';
 import { createLogger } from '../ui/logging/index.js';
+import { getErrorMessage } from '../utils/errors.js';
 const log = createLogger('atomic-file');
 /**
  * Atomic file operations using tmp-file-then-rename pattern.

package/dist/utils/atomicFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"atomicFile.js","sourceRoot":"","sources":["../../src/utils/atomicFile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"atomicFile.js","sourceRoot":"","sources":["../../src/utils/atomicFile.ts"],"names":[],"mappings":"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"}

package/dist/utils/decisionTrees.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decisionTrees.d.ts","sourceRoot":"","sources":["../../src/utils/decisionTrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA2JvD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAElE"}
+{"version":3,"file":"decisionTrees.d.ts","sourceRoot":"","sources":["../../src/utils/decisionTrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAgKvD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAElE"}

package/dist/utils/decisionTrees.js

@@ -11,6 +11,11 @@ export const DECISION_TREES = {
     dom_interaction: {
         intent: 'Interact with page elements and DOM',
         steps: [
+            {
+                question: 'Need to discover forms with semantic labels?',
+                yesCommand: 'dom form',
+                noAction: 'next',
+            },
             {
                 question: 'Need to capture a screenshot?',
                 yesCommand: 'dom screenshot',

package/dist/utils/decisionTrees.js.map

@@ -1 +1 @@
-{"version":3,"file":"decisionTrees.js","sourceRoot":"","sources":["../../src/utils/decisionTrees.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decisionTrees.js","sourceRoot":"","sources":["../../src/utils/decisionTrees.ts"],"names":[],"mappings":"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"}

package/dist/utils/errorMapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorMapping.d.ts","sourceRoot":"","sources":["../../src/utils/errorMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAoBvE;AASD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAgB1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAErE"}
+{"version":3,"file":"errorMapping.d.ts","sourceRoot":"","sources":["../../src/utils/errorMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CA0BvE;AASD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAgB1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/utils/errorMapping.js

@@ -34,10 +34,13 @@ export function getExitCodeForIPCError(errorCode) {
         case IPCErrorCode.CDP_TIMEOUT:
             return EXIT_CODES.CDP_TIMEOUT;
         case IPCErrorCode.SESSION_KILL_FAILED:
+            return EXIT_CODES.SESSION_FILE_ERROR;
         case IPCErrorCode.WORKER_START_FAILED:
+            return EXIT_CODES.CDP_CONNECTION_FAILURE;
         case IPCErrorCode.DAEMON_ERROR:
+            return EXIT_CODES.SOFTWARE_ERROR;
         case undefined:
-            return EXIT_CODES.UNHANDLED_EXCEPTION;
+            return EXIT_CODES.SOFTWARE_ERROR;
     }
 }
 /**

package/dist/utils/errorMapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"errorMapping.js","sourceRoot":"","sources":["../../src/utils/errorMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAwB;IAC7D,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,YAAY,CAAC,UAAU;YAC1B,OAAO,UAAU,CAAC,kBAAkB,CAAC;QAEvC,KAAK,YAAY,CAAC,uBAAuB;YACvC,OAAO,UAAU,CAAC,uBAAuB,CAAC;QAE5C,KAAK,YAAY,CAAC,oBAAoB;YACpC,OAAO,UAAU,CAAC,qBAAqB,CAAC;QAE1C,KAAK,YAAY,CAAC,WAAW;YAC3B,OAAO,UAAU,CAAC,WAAW,CAAC;QAEhC,KAAK,YAAY,CAAC,mBAAmB,CAAC;QACtC,KAAK,YAAY,CAAC,mBAAmB,CAAC;QACtC,KAAK,YAAY,CAAC,YAAY,CAAC;QAC/B,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,mBAAmB,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,YAAoB;IACnD,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,6BAA6B,CAAC,YAAoB;IAChE,MAAM,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAEhD,IAAI,uBAAuB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC,kBAAkB,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC/C,OAAO,UAAU,CAAC,kBAAkB,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,OAAO,UAAU,CAAC,kBAAkB,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,OAAO,uBAAuB,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"errorMapping.js","sourceRoot":"","sources":["../../src/utils/errorMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAwB;IAC7D,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,YAAY,CAAC,UAAU;YAC1B,OAAO,UAAU,CAAC,kBAAkB,CAAC;QAEvC,KAAK,YAAY,CAAC,uBAAuB;YACvC,OAAO,UAAU,CAAC,uBAAuB,CAAC;QAE5C,KAAK,YAAY,CAAC,oBAAoB;YACpC,OAAO,UAAU,CAAC,qBAAqB,CAAC;QAE1C,KAAK,YAAY,CAAC,WAAW;YAC3B,OAAO,UAAU,CAAC,WAAW,CAAC;QAEhC,KAAK,YAAY,CAAC,mBAAmB;YACnC,OAAO,UAAU,CAAC,kBAAkB,CAAC;QAEvC,KAAK,YAAY,CAAC,mBAAmB;YACnC,OAAO,UAAU,CAAC,sBAAsB,CAAC;QAE3C,KAAK,YAAY,CAAC,YAAY;YAC5B,OAAO,UAAU,CAAC,cAAc,CAAC;QAEnC,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,cAAc,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,YAAoB;IACnD,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,6BAA6B,CAAC,YAAoB;IAChE,MAAM,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAEhD,IAAI,uBAAuB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC,kBAAkB,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC/C,OAAO,UAAU,CAAC,kBAAkB,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,OAAO,UAAU,CAAC,kBAAkB,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,OAAO,uBAAuB,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/utils/exitCodes.d.ts

@@ -32,39 +32,40 @@
  * **These values are stable API** - use confidently in automation scripts.
  */
 export declare const EXIT_CODES: {
-    /** Command completed successfully */
     readonly SUCCESS: 0;
-    /** Generic failure (use specific codes when possible) */
     readonly GENERIC_FAILURE: 1;
-    /** Invalid URL format or unreachable URL */
     readonly INVALID_URL: 80;
-    /** Invalid command-line arguments or options */
     readonly INVALID_ARGUMENTS: 81;
-    /** Insufficient permissions for operation */
     readonly PERMISSION_DENIED: 82;
-    /** Requested resource not found (session, file, etc.) */
     readonly RESOURCE_NOT_FOUND: 83;
-    /** Resource already exists (duplicate session, etc.) */
     readonly RESOURCE_ALREADY_EXISTS: 84;
-    /** Resource is locked or busy */
     readonly RESOURCE_BUSY: 85;
-    /** Daemon already running when trying to start */
     readonly DAEMON_ALREADY_RUNNING: 86;
-    /** Cache invalidated by navigation or DOM changes */
     readonly STALE_CACHE: 87;
-    /** Chrome browser failed to launch */
+    readonly NO_FORMS_FOUND: 88;
+    readonly FORM_IN_IFRAME: 89;
     readonly CHROME_LAUNCH_FAILURE: 100;
-    /** CDP connection failed */
     readonly CDP_CONNECTION_FAILURE: 101;
-    /** CDP operation timed out */
     readonly CDP_TIMEOUT: 102;
-    /** Session file read/write error */
     readonly SESSION_FILE_ERROR: 103;
-    /** Unhandled exception in code */
     readonly UNHANDLED_EXCEPTION: 104;
-    /** Signal handler error */
     readonly SIGNAL_HANDLER_ERROR: 105;
-    /** Generic software error (use specific codes when possible) */
     readonly SOFTWARE_ERROR: 110;
 };
+/**
+ * Exit code registry entry with code, name, and description.
+ */
+interface ExitCodeEntry {
+    readonly code: number;
+    readonly name: string;
+    readonly description: string;
+}
+/**
+ * Exit code registry - provides documentation for all exit codes.
+ *
+ * This registry is derived from EXIT_CODES to ensure consistency.
+ * Used by help --json for machine-readable documentation.
+ */
+export declare const EXIT_CODE_REGISTRY: readonly ExitCodeEntry[];
+export {};
 //# sourceMappingURL=exitCodes.d.ts.map

package/dist/utils/exitCodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exitCodes.d.ts","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU;IACrB,qCAAqC;;IAGrC,yDAAyD;;IAGzD,4CAA4C;;IAG5C,gDAAgD;;IAGhD,6CAA6C;;IAG7C,yDAAyD;;IAGzD,wDAAwD;;IAGxD,iCAAiC;;IAGjC,kDAAkD;;IAGlD,qDAAqD;;IAGrD,sCAAsC;;IAGtC,4BAA4B;;IAG5B,8BAA8B;;IAG9B,oCAAoC;;IAGpC,kCAAkC;;IAGlC,2BAA2B;;IAG3B,gEAAgE;;CAExD,CAAC"}
+{"version":3,"file":"exitCodes.d.ts","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;CAoBb,CAAC;AAEX;;GAEG;AACH,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,aAAa,EAwFtD,CAAC"}

package/dist/utils/exitCodes.js

@@ -32,39 +32,119 @@
  * **These values are stable API** - use confidently in automation scripts.
  */
 export const EXIT_CODES = {
-    /** Command completed successfully */
     SUCCESS: 0,
-    /** Generic failure (use specific codes when possible) */
     GENERIC_FAILURE: 1,
-    /** Invalid URL format or unreachable URL */
     INVALID_URL: 80,
-    /** Invalid command-line arguments or options */
     INVALID_ARGUMENTS: 81,
-    /** Insufficient permissions for operation */
     PERMISSION_DENIED: 82,
-    /** Requested resource not found (session, file, etc.) */
     RESOURCE_NOT_FOUND: 83,
-    /** Resource already exists (duplicate session, etc.) */
     RESOURCE_ALREADY_EXISTS: 84,
-    /** Resource is locked or busy */
     RESOURCE_BUSY: 85,
-    /** Daemon already running when trying to start */
     DAEMON_ALREADY_RUNNING: 86,
-    /** Cache invalidated by navigation or DOM changes */
     STALE_CACHE: 87,
-    /** Chrome browser failed to launch */
+    NO_FORMS_FOUND: 88,
+    FORM_IN_IFRAME: 89,
     CHROME_LAUNCH_FAILURE: 100,
-    /** CDP connection failed */
     CDP_CONNECTION_FAILURE: 101,
-    /** CDP operation timed out */
     CDP_TIMEOUT: 102,
-    /** Session file read/write error */
     SESSION_FILE_ERROR: 103,
-    /** Unhandled exception in code */
     UNHANDLED_EXCEPTION: 104,
-    /** Signal handler error */
     SIGNAL_HANDLER_ERROR: 105,
-    /** Generic software error (use specific codes when possible) */
     SOFTWARE_ERROR: 110,
 };
+/**
+ * Exit code registry - provides documentation for all exit codes.
+ *
+ * This registry is derived from EXIT_CODES to ensure consistency.
+ * Used by help --json for machine-readable documentation.
+ */
+export const EXIT_CODE_REGISTRY = [
+    { code: EXIT_CODES.SUCCESS, name: 'SUCCESS', description: 'Operation completed successfully' },
+    {
+        code: EXIT_CODES.GENERIC_FAILURE,
+        name: 'GENERIC_FAILURE',
+        description: 'Generic failure (use specific codes when possible)',
+    },
+    {
+        code: EXIT_CODES.INVALID_URL,
+        name: 'INVALID_URL',
+        description: 'Invalid URL format or unreachable URL',
+    },
+    {
+        code: EXIT_CODES.INVALID_ARGUMENTS,
+        name: 'INVALID_ARGUMENTS',
+        description: 'Invalid command-line arguments or options',
+    },
+    {
+        code: EXIT_CODES.PERMISSION_DENIED,
+        name: 'PERMISSION_DENIED',
+        description: 'Insufficient permissions for operation',
+    },
+    {
+        code: EXIT_CODES.RESOURCE_NOT_FOUND,
+        name: 'RESOURCE_NOT_FOUND',
+        description: 'Requested resource not found (session, file, etc.)',
+    },
+    {
+        code: EXIT_CODES.RESOURCE_ALREADY_EXISTS,
+        name: 'RESOURCE_ALREADY_EXISTS',
+        description: 'Resource already exists (duplicate session, etc.)',
+    },
+    {
+        code: EXIT_CODES.RESOURCE_BUSY,
+        name: 'RESOURCE_BUSY',
+        description: 'Resource is locked or busy',
+    },
+    {
+        code: EXIT_CODES.DAEMON_ALREADY_RUNNING,
+        name: 'DAEMON_ALREADY_RUNNING',
+        description: 'Daemon is already running',
+    },
+    {
+        code: EXIT_CODES.STALE_CACHE,
+        name: 'STALE_CACHE',
+        description: 'Cache invalidated by navigation or DOM changes',
+    },
+    {
+        code: EXIT_CODES.NO_FORMS_FOUND,
+        name: 'NO_FORMS_FOUND',
+        description: 'No forms discovered on the page',
+    },
+    {
+        code: EXIT_CODES.FORM_IN_IFRAME,
+        name: 'FORM_IN_IFRAME',
+        description: 'Form is inside an iframe (cross-origin or same-origin)',
+    },
+    {
+        code: EXIT_CODES.CHROME_LAUNCH_FAILURE,
+        name: 'CHROME_LAUNCH_FAILURE',
+        description: 'Chrome browser failed to launch',
+    },
+    {
+        code: EXIT_CODES.CDP_CONNECTION_FAILURE,
+        name: 'CDP_CONNECTION_FAILURE',
+        description: 'Failed to connect to Chrome DevTools Protocol',
+    },
+    { code: EXIT_CODES.CDP_TIMEOUT, name: 'CDP_TIMEOUT', description: 'CDP operation timed out' },
+    {
+        code: EXIT_CODES.SESSION_FILE_ERROR,
+        name: 'SESSION_FILE_ERROR',
+        description: 'Session file read/write error',
+    },
+    {
+        code: EXIT_CODES.UNHANDLED_EXCEPTION,
+        name: 'UNHANDLED_EXCEPTION',
+        description: 'Unhandled exception in code',
+    },
+    {
+        code: EXIT_CODES.SIGNAL_HANDLER_ERROR,
+        name: 'SIGNAL_HANDLER_ERROR',
+        description: 'Signal handler error',
+    },
+    {
+        code: EXIT_CODES.SOFTWARE_ERROR,
+        name: 'SOFTWARE_ERROR',
+        description: 'Generic software error (use specific codes when possible)',
+    },
+];
 //# sourceMappingURL=exitCodes.js.map

package/dist/utils/exitCodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qCAAqC;IACrC,OAAO,EAAE,CAAC;IAEV,yDAAyD;IACzD,eAAe,EAAE,CAAC;IAElB,4CAA4C;IAC5C,WAAW,EAAE,EAAE;IAEf,gDAAgD;IAChD,iBAAiB,EAAE,EAAE;IAErB,6CAA6C;IAC7C,iBAAiB,EAAE,EAAE;IAErB,yDAAyD;IACzD,kBAAkB,EAAE,EAAE;IAEtB,wDAAwD;IACxD,uBAAuB,EAAE,EAAE;IAE3B,iCAAiC;IACjC,aAAa,EAAE,EAAE;IAEjB,kDAAkD;IAClD,sBAAsB,EAAE,EAAE;IAE1B,qDAAqD;IACrD,WAAW,EAAE,EAAE;IAEf,sCAAsC;IACtC,qBAAqB,EAAE,GAAG;IAE1B,4BAA4B;IAC5B,sBAAsB,EAAE,GAAG;IAE3B,8BAA8B;IAC9B,WAAW,EAAE,GAAG;IAEhB,oCAAoC;IACpC,kBAAkB,EAAE,GAAG;IAEvB,kCAAkC;IAClC,mBAAmB,EAAE,GAAG;IAExB,2BAA2B;IAC3B,oBAAoB,EAAE,GAAG;IAEzB,gEAAgE;IAChE,cAAc,EAAE,GAAG;CACX,CAAC"}
+{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../src/utils/exitCodes.ts"],"names":[],"mappings":"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"}

package/dist/utils/shellDetection.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shell quote damage detection utilities.
+ *
+ * Detects when shell quote handling has corrupted selectors or scripts,
+ * providing actionable suggestions for recovery.
+ */
+export interface ShellDamageResult {
+    damaged: boolean;
+    type?: 'attribute-selector' | 'unquoted-argument';
+    details?: string;
+    suggestion?: string;
+}
+/**
+ * Checks if a selector contains attribute syntax.
+ *
+ * @param selector - CSS selector to check
+ * @returns True if selector contains attribute syntax
+ */
+export declare function hasAttributeSelector(selector: string): boolean;
+/**
+ * Detects shell quote damage in CSS selectors.
+ *
+ * @param selector - The selector as received by the command
+ * @returns Detection result with details and suggestions
+ */
+export declare function detectSelectorQuoteDamage(selector: string): ShellDamageResult;
+/**
+ * Detects shell quote damage in JavaScript expressions.
+ *
+ * @param script - The script as received by the command
+ * @returns Detection result with details and suggestions
+ */
+export declare function detectScriptQuoteDamage(script: string): ShellDamageResult;
+//# sourceMappingURL=shellDetection.d.ts.map

package/dist/utils/shellDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellDetection.d.ts","sourceRoot":"","sources":["../../src/utils/shellDetection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAkED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAOzE"}