ado-sync 0.1.29 → 0.1.31

package/dist/parsers/swift.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * Swift / XCUITest parser for azure-test-sync.
+ *
+ * Handles iOS and macOS UI-automation tests written with Apple's XCTest framework.
+ * Tests are `func test*()` methods inside classes that extend `XCTestCase`.
+ *
+ * Detected test functions:
+ *   func testUserCanLogin() { ... }
+ *   func test_login_succeeds() { ... }
+ *
+ * Detected class blocks (used as the test group / describe equivalent):
+ *   class LoginTests: XCTestCase { ... }
+ *
+ * Source mapping:
+ *   /// Swift doc comment above func test*        → TC Title (first non-numbered line)
+ *   JSDoc /** ... * / doc comment above func test* → TC Title + Steps (same format)
+ *   Numbered lines "N. text"                → TC Steps (action)
+ *   "N. Check: text"                        → TC Steps (expected result column)
+ *   // @tags: smoke, regression             → TC Tags (comma-separated list)
+ *   // @smoke                               → TC Tag (single-word shorthand)
+ *   // @{tagPrefix}:N  comment above func   → Azure TC ID (written back after push)
+ *   {fileBasename} > {ClassName} > {method} → automatedTestName
+ *
+ * Method name → title fallback:
+ *   "testUserCanLogin" → "User can login"
+ *   "test_submit_form" → "Submit form"
+ *
+ * ID writeback:
+ *   Inserts / updates  // @tc:12345  immediately above the func test*() line.
+ *
+ * Path-based auto-tagging: directory segments starting with '@' become tags.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSwiftFile = parseSwiftFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const shared_1 = require("./shared");
+// ─── Test method detection ────────────────────────────────────────────────────
+const TEST_METHOD_RE = /^\s*func\s+(test\w+)\s*\(/;
+const CLASS_RE = /^\s*(?:(?:open|final|public|internal|private)\s+)*class\s+(\w+)\s*(?::\s*[\w, ]+)?/;
+// ─── Indentation helpers ──────────────────────────────────────────────────────
+function getIndentLength(line) {
+    return (line.match(/^(\s*)/) ?? ['', ''])[1].length;
+}
+// ─── Enclosing class ──────────────────────────────────────────────────────────
+function findEnclosingClass(lines, methodLineIdx) {
+    const methodIndent = getIndentLength(lines[methodLineIdx]);
+    for (let i = methodLineIdx - 1; i >= 0; i--) {
+        const lineIndent = getIndentLength(lines[i]);
+        if (lineIndent < methodIndent) {
+            const m = lines[i].trim().match(CLASS_RE);
+            if (m)
+                return m[1];
+        }
+    }
+    return undefined;
+}
+// ─── Doc comment extraction ───────────────────────────────────────────────────
+/**
+ * Extract Swift doc comments above func test*().
+ * Handles both triple-slash (///) single-line and block (/* * /) style.
+ * Skips blank lines and single-line // comments on the way up.
+ */
+function extractDocBefore(lines, methodLineIdx) {
+    let i = methodLineIdx - 1;
+    // Skip blank lines and non-doc single-line comments
+    while (i >= 0) {
+        const t = lines[i].trim();
+        if (t === '' || (t.startsWith('//') && !t.startsWith('///'))) {
+            i--;
+            continue;
+        }
+        break;
+    }
+    if (i < 0)
+        return [];
+    // /// triple-slash style (Swift idiomatic)
+    if (lines[i].trim().startsWith('///')) {
+        const docLines = [];
+        while (i >= 0 && lines[i].trim().startsWith('///')) {
+            docLines.unshift(lines[i].trim().replace(/^\/\/\/\s?/, ''));
+            i--;
+        }
+        return docLines.filter((l) => l !== '');
+    }
+    // /** ... */ block style
+    if (!lines[i].trim().endsWith('*/'))
+        return [];
+    const raw = [];
+    raw.unshift(lines[i]);
+    i--;
+    while (i >= 0) {
+        raw.unshift(lines[i]);
+        if (lines[i].trim().startsWith('/**') || lines[i].trim().startsWith('/*'))
+            break;
+        i--;
+    }
+    return raw
+        .map((l) => l
+        .replace(/^\s*\/\*\*?\s?/, '')
+        .replace(/\s*\*\/\s*$/, '')
+        .replace(/^\s*\*\s?/, '')
+        .trim())
+        .filter((l) => l !== '');
+}
+function extractCommentMetadataAbove(lines, methodLineIdx, tagPrefix) {
+    const tags = [];
+    let azureId;
+    const idRe = new RegExp(`//\\s*@${tagPrefix}:(\\d+)`);
+    const tagsListRe = /\/\/\s*@tags?\s*:\s*(.+)/i;
+    const singleTagRe = /\/\/\s*@(\w+)\s*$/;
+    for (let i = methodLineIdx - 1; i >= 0 && i >= methodLineIdx - 25; i--) {
+        const trimmed = lines[i].trim();
+        if (trimmed === '')
+            break;
+        if (!trimmed.startsWith('//') && !trimmed.startsWith('*') && !trimmed.startsWith('/*'))
+            break;
+        const idMatch = trimmed.match(idRe);
+        if (idMatch && azureId === undefined) {
+            azureId = parseInt(idMatch[1], 10);
+            continue;
+        }
+        const tagsMatch = trimmed.match(tagsListRe);
+        if (tagsMatch) {
+            tags.push(...tagsMatch[1].split(',').map((t) => t.trim()).filter(Boolean));
+            continue;
+        }
+        const singleTag = trimmed.match(singleTagRe);
+        if (singleTag && singleTag[1] !== tagPrefix) {
+            tags.push(singleTag[1]);
+            continue;
+        }
+    }
+    return { azureId, tags };
+}
+// ─── Method name → human-readable title ──────────────────────────────────────
+/**
+ * Convert a Swift test method name to a sentence-style title.
+ *   testUserCanLogin         → "User can login"
+ *   testLoginFails_badPassword → "Login fails bad password"
+ *   test_submit_form         → "Submit form"
+ */
+function methodNameToTitle(name) {
+    let s = name.replace(/^test_?/, '');
+    if (!s)
+        return name;
+    // snake_case → words
+    s = s.replace(/_/g, ' ');
+    // camelCase → words
+    s = s.replace(/([a-z])([A-Z])/g, '$1 $2').replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
+    s = s.toLowerCase().replace(/^./, (c) => c.toUpperCase());
+    return s;
+}
+// ─── Doc → title + steps ─────────────────────────────────────────────────────
+const NUMBERED_STEP_RE = /^\d+\.\s+(.+)$/;
+const CHECK_RE = /^[Cc]heck:\s+(.+)$/;
+const META_RE = /^(?:test\s+case|user\s+story)[\s:]/i;
+function parseSummary(docLines, fallbackTitle) {
+    let title = '';
+    const steps = [];
+    for (const line of docLines) {
+        if (!line || META_RE.test(line))
+            continue;
+        const numMatch = NUMBERED_STEP_RE.exec(line);
+        if (numMatch) {
+            const content = numMatch[1].trim();
+            const checkMatch = CHECK_RE.exec(content);
+            if (checkMatch) {
+                steps.push({ keyword: 'Then', text: checkMatch[1].trim() });
+            }
+            else {
+                steps.push({ keyword: 'Step', text: content });
+            }
+            continue;
+        }
+        if (!title)
+            title = line;
+    }
+    return { title: title || fallbackTitle, steps };
+}
+// ─── Public parser ────────────────────────────────────────────────────────────
+function parseSwiftFile(filePath, tagPrefix, linkConfigs) {
+    const source = fs.readFileSync(filePath, 'utf8');
+    const lines = source.split('\n');
+    const fileBaseName = path.basename(filePath).replace(/\.swift$/, '');
+    const pathTags = (0, shared_1.extractPathTags)(filePath);
+    const results = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(TEST_METHOD_RE);
+        if (!m)
+            continue;
+        const methodName = m[1];
+        const methodLineIdx = i;
+        const docLines = extractDocBefore(lines, methodLineIdx);
+        const { azureId, tags: cTags } = extractCommentMetadataAbove(lines, methodLineIdx, tagPrefix);
+        const className = findEnclosingClass(lines, methodLineIdx);
+        const allTags = [...new Set([...pathTags, ...cTags])];
+        const fallbackTitle = methodNameToTitle(methodName);
+        const { title, steps } = parseSummary(docLines, fallbackTitle);
+        const automatedTestName = className
+            ? [fileBaseName, className, methodName].join(' > ')
+            : [fileBaseName, methodName].join(' > ');
+        results.push({
+            filePath,
+            title,
+            steps,
+            tags: allTags,
+            azureId: azureId !== undefined && !isNaN(azureId) ? azureId : undefined,
+            line: methodLineIdx + 1,
+            linkRefs: (0, shared_1.extractLinkRefs)(allTags, linkConfigs),
+            automatedTestName,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=swift.js.map

package/dist/parsers/swift.js.map

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

package/dist/parsers/testcafe.d.ts

@@ -0,0 +1,32 @@
+/**
+ * TestCafe test parser for azure-test-sync.
+ *
+ * TestCafe uses a fixture / test API that is fundamentally different from
+ * describe() / it(), so it gets its own parser.
+ *
+ * Detected test functions:
+ *   test('title', async t => { ... })
+ *   test.skip('title', async t => { ... })
+ *   test.only('title', async t => { ... })
+ *
+ * Detected fixture blocks (used as the test group / describe equivalent):
+ *   fixture('Fixture title')
+ *   fixture.skip('Fixture title')
+ *   fixture.only('Fixture title')
+ *
+ * Source mapping:
+ *   JSDoc /** ... * / first non-numbered line    → TC Title
+ *   Numbered lines "N. text"                     → TC Steps (action)
+ *   "N. Check: text"                             → TC Steps (expected result column)
+ *   // @tags: smoke, regression                  → TC Tags (comma-separated list)
+ *   // @smoke                                    → TC Tag (single-word shorthand)
+ *   // @{tagPrefix}:N  comment above test()      → Azure TC ID (written back after push)
+ *   {fileBasename} > {fixture} > {test title}    → automatedTestName
+ *
+ * ID writeback:
+ *   Inserts / updates  // @tc:12345  immediately above the test() line.
+ *
+ * Path-based auto-tagging: directory segments starting with '@' become tags.
+ */
+import { LinkConfig, ParsedTest } from '../types';
+export declare function parseTestCafeFile(filePath: string, tagPrefix: string, linkConfigs?: LinkConfig[]): ParsedTest[];

package/dist/parsers/testcafe.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * TestCafe test parser for azure-test-sync.
+ *
+ * TestCafe uses a fixture / test API that is fundamentally different from
+ * describe() / it(), so it gets its own parser.
+ *
+ * Detected test functions:
+ *   test('title', async t => { ... })
+ *   test.skip('title', async t => { ... })
+ *   test.only('title', async t => { ... })
+ *
+ * Detected fixture blocks (used as the test group / describe equivalent):
+ *   fixture('Fixture title')
+ *   fixture.skip('Fixture title')
+ *   fixture.only('Fixture title')
+ *
+ * Source mapping:
+ *   JSDoc /** ... * / first non-numbered line    → TC Title
+ *   Numbered lines "N. text"                     → TC Steps (action)
+ *   "N. Check: text"                             → TC Steps (expected result column)
+ *   // @tags: smoke, regression                  → TC Tags (comma-separated list)
+ *   // @smoke                                    → TC Tag (single-word shorthand)
+ *   // @{tagPrefix}:N  comment above test()      → Azure TC ID (written back after push)
+ *   {fileBasename} > {fixture} > {test title}    → automatedTestName
+ *
+ * ID writeback:
+ *   Inserts / updates  // @tc:12345  immediately above the test() line.
+ *
+ * Path-based auto-tagging: directory segments starting with '@' become tags.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTestCafeFile = parseTestCafeFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const shared_1 = require("./shared");
+// ─── Test / fixture detection ─────────────────────────────────────────────────
+const TEST_CALL_RE = /^(?:test|test\.skip|test\.only)\s*\(/;
+const TEST_TITLE_RE = /^(?:test|test\.skip|test\.only)\s*\(\s*(['"`])((?:\\.|[^\\])*?)\1/;
+const FIXTURE_TITLE_RE = /^(?:fixture|fixture\.skip|fixture\.only)\s*\(\s*(['"`])((?:\\.|[^\\])*?)\1/;
+// ─── Indentation helpers ──────────────────────────────────────────────────────
+function getIndentLength(line) {
+    return (line.match(/^(\s*)/) ?? ['', ''])[1].length;
+}
+// ─── Enclosing fixture ────────────────────────────────────────────────────────
+/**
+ * Walk backward from the test() line to find the most recent fixture() title.
+ */
+function findEnclosingFixture(lines, testLineIdx) {
+    const testIndent = getIndentLength(lines[testLineIdx]);
+    for (let i = testLineIdx - 1; i >= 0; i--) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const lineIndent = getIndentLength(line);
+        if (lineIndent <= testIndent) {
+            const m = trimmed.match(FIXTURE_TITLE_RE);
+            if (m) {
+                return m[2].replace(/\\'/g, "'").replace(/\\"/g, '"').replace(/\\`/g, '`');
+            }
+        }
+    }
+    return undefined;
+}
+// ─── JSDoc extraction ─────────────────────────────────────────────────────────
+function extractJsdocBefore(lines, testLineIdx) {
+    let i = testLineIdx - 1;
+    while (i >= 0) {
+        const t = lines[i].trim();
+        if (t === '' || t.startsWith('//')) {
+            i--;
+            continue;
+        }
+        break;
+    }
+    if (i < 0 || !lines[i].trim().endsWith('*/'))
+        return [];
+    const raw = [];
+    raw.unshift(lines[i]);
+    i--;
+    while (i >= 0) {
+        raw.unshift(lines[i]);
+        if (lines[i].trim().startsWith('/**'))
+            break;
+        i--;
+    }
+    return raw
+        .map((l) => l
+        .replace(/^\s*\/\*\*\s?/, '')
+        .replace(/\s*\*\/\s*$/, '')
+        .replace(/^\s*\*\s?/, '')
+        .trim())
+        .filter((l) => l !== '');
+}
+function extractCommentMetadataAbove(lines, testLineIdx, tagPrefix) {
+    const tags = [];
+    let azureId;
+    const idRe = new RegExp(`//\\s*@${tagPrefix}:(\\d+)`);
+    const tagsListRe = /\/\/\s*@tags?\s*:\s*(.+)/i;
+    const singleTagRe = /\/\/\s*@(\w+)\s*$/;
+    for (let i = testLineIdx - 1; i >= 0 && i >= testLineIdx - 25; i--) {
+        const trimmed = lines[i].trim();
+        if (trimmed === '')
+            break;
+        if (!trimmed.startsWith('//') && !trimmed.startsWith('*') && !trimmed.startsWith('/*'))
+            break;
+        const idMatch = trimmed.match(idRe);
+        if (idMatch && azureId === undefined) {
+            azureId = parseInt(idMatch[1], 10);
+            continue;
+        }
+        const tagsMatch = trimmed.match(tagsListRe);
+        if (tagsMatch) {
+            tags.push(...tagsMatch[1].split(',').map((t) => t.trim()).filter(Boolean));
+            continue;
+        }
+        const singleTag = trimmed.match(singleTagRe);
+        if (singleTag && singleTag[1] !== tagPrefix) {
+            tags.push(singleTag[1]);
+            continue;
+        }
+    }
+    return { azureId, tags };
+}
+// ─── JSDoc → title + steps ────────────────────────────────────────────────────
+const NUMBERED_STEP_RE = /^\d+\.\s+(.+)$/;
+const CHECK_RE = /^[Cc]heck:\s+(.+)$/;
+const META_RE = /^(?:test\s+case|user\s+story)[\s:]/i;
+function parseSummary(jsdocLines, fallbackTitle) {
+    let title = '';
+    const steps = [];
+    for (const line of jsdocLines) {
+        if (!line || META_RE.test(line))
+            continue;
+        const numMatch = NUMBERED_STEP_RE.exec(line);
+        if (numMatch) {
+            const content = numMatch[1].trim();
+            const checkMatch = CHECK_RE.exec(content);
+            if (checkMatch) {
+                steps.push({ keyword: 'Then', text: checkMatch[1].trim() });
+            }
+            else {
+                steps.push({ keyword: 'Step', text: content });
+            }
+            continue;
+        }
+        if (!title)
+            title = line;
+    }
+    return { title: title || fallbackTitle, steps };
+}
+// ─── Public parser ────────────────────────────────────────────────────────────
+function parseTestCafeFile(filePath, tagPrefix, linkConfigs) {
+    const source = fs.readFileSync(filePath, 'utf8');
+    const lines = source.split('\n');
+    const fileBaseName = path.basename(filePath)
+        .replace(/\.(spec|test)\.(js|ts|mjs|cjs)$/, '')
+        .replace(/\.(js|ts|mjs|cjs)$/, '');
+    const pathTags = (0, shared_1.extractPathTags)(filePath);
+    const results = [];
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (!TEST_CALL_RE.test(trimmed))
+            continue;
+        const testLineIdx = i;
+        const m = trimmed.match(TEST_TITLE_RE);
+        if (!m)
+            continue;
+        const callTitle = m[2]
+            .replace(/\\'/g, "'")
+            .replace(/\\"/g, '"')
+            .replace(/\\`/g, '`')
+            .replace(/\\\\/g, '\\');
+        if (!callTitle)
+            continue;
+        const jsdocLines = extractJsdocBefore(lines, testLineIdx);
+        const { azureId, tags: cTags } = extractCommentMetadataAbove(lines, testLineIdx, tagPrefix);
+        const fixture = findEnclosingFixture(lines, testLineIdx);
+        const allTags = [...new Set([...pathTags, ...cTags])];
+        const { title, steps } = parseSummary(jsdocLines, callTitle);
+        const automatedTestName = fixture
+            ? [fileBaseName, fixture, callTitle].join(' > ')
+            : [fileBaseName, callTitle].join(' > ');
+        results.push({
+            filePath,
+            title,
+            steps,
+            tags: allTags,
+            azureId: azureId !== undefined && !isNaN(azureId) ? azureId : undefined,
+            line: testLineIdx + 1,
+            linkRefs: (0, shared_1.extractLinkRefs)(allTags, linkConfigs),
+            automatedTestName,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=testcafe.js.map

package/dist/parsers/testcafe.js.map

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

package/dist/sync/engine.d.ts

@@ -1,13 +1,16 @@
 /**
  * Sync engine — orchestrates push, pull, and status operations.
  */
+import { AiSummaryOpts } from '../ai/summarizer';
 import { SyncConfig, SyncResult } from '../types';
 export interface SyncOpts {
     dryRun?: boolean;
     tags?: string;
     /** Called after each test case is processed. Useful for rendering a live progress bar. */
     onProgress?: (done: number, total: number, result: SyncResult) => void;
+    /** AI auto-summary options: generate title/steps for tests that have none. */
+    aiSummary?: AiSummaryOpts;
 }
 export declare function push(config: SyncConfig, configDir: string, opts?: SyncOpts): Promise<SyncResult[]>;
 export declare function pull(config: SyncConfig, configDir: string, opts?: SyncOpts): Promise<SyncResult[]>;
-export declare function status(config: SyncConfig, configDir: string, opts?: Pick<SyncOpts, 'tags' | 'onProgress'>): Promise<SyncResult[]>;
+export declare function status(config: SyncConfig, configDir: string, opts?: Pick<SyncOpts, 'tags' | 'onProgress' | 'aiSummary'>): Promise<SyncResult[]>;

package/dist/sync/engine.js

@@ -46,16 +46,20 @@ const tag_expressions_1 = __importDefault(require("@cucumber/tag-expressions"));
 const fs = __importStar(require("fs"));
 const glob_1 = require("glob");
 const path = __importStar(require("path"));
+const summarizer_1 = require("../ai/summarizer");
 const client_1 = require("../azure/client");
 const test_cases_1 = require("../azure/test-cases");
 const csharp_1 = require("../parsers/csharp");
 const csv_1 = require("../parsers/csv");
+const dart_1 = require("../parsers/dart");
 const excel_1 = require("../parsers/excel");
 const gherkin_1 = require("../parsers/gherkin");
 const java_1 = require("../parsers/java");
 const javascript_1 = require("../parsers/javascript");
 const markdown_1 = require("../parsers/markdown");
 const python_1 = require("../parsers/python");
+const swift_1 = require("../parsers/swift");
+const testcafe_1 = require("../parsers/testcafe");
 const cache_1 = require("./cache");
 const writeback_1 = require("./writeback");
 // ─── Tag filtering ────────────────────────────────────────────────────────────
@@ -116,8 +120,24 @@ async function parseLocalFiles(filePaths, config, tagsFilter) {
                     tests = (0, python_1.parsePythonFile)(fp, tagPrefix, linkConfigs);
                     break;
                 case 'javascript':
+                case 'playwright':
+                case 'puppeteer':
+                case 'cypress':
+                case 'detox':
                     tests = (0, javascript_1.parseJavaScriptFile)(fp, tagPrefix, linkConfigs);
                     break;
+                case 'testcafe':
+                    tests = (0, testcafe_1.parseTestCafeFile)(fp, tagPrefix, linkConfigs);
+                    break;
+                case 'espresso':
+                    tests = (0, java_1.parseJavaFile)(fp, tagPrefix, linkConfigs);
+                    break;
+                case 'xcuitest':
+                    tests = (0, swift_1.parseSwiftFile)(fp, tagPrefix, linkConfigs);
+                    break;
+                case 'flutter':
+                    tests = (0, dart_1.parseDartFile)(fp, tagPrefix, linkConfigs);
+                    break;
                 default:
                     tests = (0, markdown_1.parseMarkdownFile)(fp, tagPrefix, linkConfigs, attachmentsConfig);
             }
@@ -171,6 +191,28 @@ async function push(config, configDir, opts = {}) {
 async function pushSingle(config, configDir, opts) {
     const files = await discoverFiles(config.local.include, config.local.exclude, configDir);
     const tests = await parseLocalFiles(files, config, opts.tags);
+    // AI auto-summary: for code-based local types, default to the local node-llama-cpp
+    // provider (with heuristic fallback) when no explicit aiSummary opts are provided.
+    // If no GGUF model path is set, the local provider transparently falls back to
+    // heuristic mode so the push always succeeds even without a model installed.
+    const CODE_TYPES = new Set(['javascript', 'playwright', 'puppeteer', 'cypress', 'testcafe', 'detox', 'espresso', 'xcuitest', 'flutter', 'java', 'csharp', 'python']);
+    const effectiveAiOpts = opts.aiSummary ?? (CODE_TYPES.has(config.local.type) ? { provider: 'local', heuristicFallback: true } : undefined);
+    if (effectiveAiOpts) {
+        for (const test of tests) {
+            const needsSteps = test.steps.length === 0;
+            const needsDescription = !test.description;
+            if (needsSteps || needsDescription) {
+                const result = await (0, summarizer_1.summarizeTest)(test, config.local.type, effectiveAiOpts);
+                if (needsSteps) {
+                    test.title = result.title;
+                    test.steps = result.steps;
+                }
+                if (needsDescription && result.description) {
+                    test.description = result.description;
+                }
+            }
+        }
+    }
     const client = await client_1.AzureClient.create(config);
     const tagPrefix = config.sync?.tagPrefix ?? 'tc';
     const titleField = config.sync?.titleField ?? 'System.Title';
@@ -467,7 +509,7 @@ async function pullSingle(config, configDir, opts) {
 }
 // ─── Status ───────────────────────────────────────────────────────────────────
 async function status(config, configDir, opts = {}) {
-    return push(config, configDir, { dryRun: true, tags: opts.tags, onProgress: opts.onProgress });
+    return push(config, configDir, { dryRun: true, tags: opts.tags, onProgress: opts.onProgress, aiSummary: opts.aiSummary });
 }
 // ─── Cache helpers ────────────────────────────────────────────────────────────
 function updateCacheEntry(cache, test, remote) {
@@ -491,7 +533,11 @@ function applyRemoteToLocal(test, newTitle, newSteps, newDescription, localType,
     else if (localType === 'markdown') {
         applyRemoteToMarkdown(test, newTitle, newSteps, newDescription, tagPrefix);
     }
-    // csv / excel: pull not supported (files are typically generated by external tools)
+    else if (localType === 'csv') {
+        (0, csv_1.applyRemoteToCsv)(test.filePath, test.title, newTitle, newSteps);
+    }
+    // excel: pull not yet supported (in-place XML surgery for xlsx is complex)
+    // csharp / java / python / javascript: pull not supported (code files are managed locally)
 }
 function applyRemoteToGherkin(test, newTitle, newSteps) {
     const raw = fs.readFileSync(test.filePath, 'utf8');