ado-sync 0.1.2

package/dist/azure/test-cases.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * CRUD operations for Azure DevOps Test Cases (Work Items of type "Test Case").
+ *
+ * Azure stores test steps as XML in the field:
+ *   Microsoft.VSTS.TCM.Steps
+ *
+ * Step XML shape:
+ *   <steps id="0" last="N">
+ *     <step id="2" type="ValidateStep">
+ *       <parameterizedString isformatted="true">&lt;DIV&gt;Action text&lt;/DIV&gt;</parameterizedString>
+ *       <parameterizedString isformatted="true">&lt;DIV&gt;Expected text&lt;/DIV&gt;</parameterizedString>
+ *       <description/>
+ *     </step>
+ *   </steps>
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTestCase = getTestCase;
+exports.createTestCase = createTestCase;
+exports.updateTestCase = updateTestCase;
+exports.updateLocalFromAzure = updateLocalFromAzure;
+exports.getTestCasesInSuite = getTestCasesInSuite;
+const fast_xml_parser_1 = require("fast-xml-parser");
+// ─── XML helpers ─────────────────────────────────────────────────────────────
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function wrapDiv(text) {
+    return `<DIV><P><B>${escapeHtml(text)}</B></P></DIV>`;
+}
+function buildStepsXml(steps) {
+    if (steps.length === 0)
+        return '<steps id="0" last="1"/>';
+    const builder = new fast_xml_parser_1.XMLBuilder({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        format: false,
+    });
+    const stepNodes = steps.map((s, i) => ({
+        '@_id': String(i + 2),
+        '@_type': 'ValidateStep',
+        parameterizedString: [
+            { '@_isformatted': 'true', '#text': wrapDiv(s.action) },
+            { '@_isformatted': 'true', '#text': wrapDiv(s.expected || '') },
+        ],
+        description: '',
+    }));
+    const xml = builder.build({
+        steps: {
+            '@_id': '0',
+            '@_last': String(steps.length + 1),
+            step: stepNodes,
+        },
+    });
+    return xml;
+}
+function parseStepsXml(xml) {
+    if (!xml)
+        return [];
+    const parser = new fast_xml_parser_1.XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        isArray: (name) => name === 'step' || name === 'parameterizedString',
+    });
+    let parsed;
+    try {
+        parsed = parser.parse(xml);
+    }
+    catch {
+        return [];
+    }
+    const rawSteps = parsed?.steps?.step ?? [];
+    return rawSteps.map((s) => {
+        const strings = s.parameterizedString ?? [];
+        const stripTags = (v) => String(v ?? '')
+            .replace(/<[^>]+>/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+        return {
+            action: stripTags(strings[0]?.['#text'] ?? strings[0] ?? ''),
+            expected: stripTags(strings[1]?.['#text'] ?? strings[1] ?? ''),
+        };
+    });
+}
+// ─── Tag helpers ─────────────────────────────────────────────────────────────
+function tagsFromString(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(/[;,]/)
+        .map((t) => t.trim())
+        .filter(Boolean);
+}
+// ─── API layer ───────────────────────────────────────────────────────────────
+async function getTestCase(client, id) {
+    const wit = await client.getWitApi();
+    const fields = [
+        'System.Title',
+        'System.Description',
+        'Microsoft.VSTS.TCM.Steps',
+        'System.Tags',
+        'System.ChangedDate',
+        'System.AreaPath',
+        'System.IterationPath',
+    ];
+    let wi;
+    try {
+        wi = await wit.getWorkItem(id, fields);
+    }
+    catch {
+        return null;
+    }
+    if (!wi)
+        return null;
+    const f = wi.fields ?? {};
+    return {
+        id,
+        title: f['System.Title'] ?? '',
+        description: f['System.Description'] ?? '',
+        steps: parseStepsXml(f['Microsoft.VSTS.TCM.Steps'] ?? ''),
+        tags: tagsFromString(f['System.Tags']),
+        changedDate: f['System.ChangedDate'],
+        areaPath: f['System.AreaPath'],
+        iterationPath: f['System.IterationPath'],
+    };
+}
+async function createTestCase(client, test, config) {
+    const wit = await client.getWitApi();
+    const steps = test.steps.map((s) => ({
+        action: `${s.keyword} ${s.text}`.trim(),
+        expected: s.expected ?? '',
+    }));
+    const syncCfg = config.sync ?? {};
+    const patchDoc = [
+        { op: 'add', path: '/fields/System.Title', value: test.title },
+        { op: 'add', path: '/fields/Microsoft.VSTS.TCM.Steps', value: buildStepsXml(steps) },
+    ];
+    if (test.description) {
+        patchDoc.push({ op: 'add', path: '/fields/System.Description', value: test.description });
+    }
+    const filteredTags = test.tags
+        .filter((t) => !t.startsWith(syncCfg.tagPrefix + ':'))
+        .join('; ');
+    if (filteredTags) {
+        patchDoc.push({ op: 'add', path: '/fields/System.Tags', value: filteredTags });
+    }
+    if (syncCfg.areaPath) {
+        patchDoc.push({ op: 'add', path: '/fields/System.AreaPath', value: syncCfg.areaPath });
+    }
+    if (syncCfg.iterationPath) {
+        patchDoc.push({ op: 'add', path: '/fields/System.IterationPath', value: syncCfg.iterationPath });
+    }
+    const wi = await wit.createWorkItem({}, patchDoc, config.project, 'Test Case');
+    if (!wi?.id)
+        throw new Error(`Failed to create test case for: ${test.title}`);
+    // Add to test suite
+    const suiteId = config.testPlan.suiteId;
+    if (suiteId) {
+        await addTestCaseToSuite(client, config, wi.id, suiteId);
+    }
+    else {
+        await addTestCaseToRootSuite(client, config, wi.id);
+    }
+    return wi.id;
+}
+async function updateTestCase(client, id, test, config) {
+    const wit = await client.getWitApi();
+    const steps = test.steps.map((s) => ({
+        action: `${s.keyword} ${s.text}`.trim(),
+        expected: s.expected ?? '',
+    }));
+    const syncCfg = config.sync ?? {};
+    const filteredTags = test.tags
+        .filter((t) => !t.startsWith(syncCfg.tagPrefix + ':'))
+        .join('; ');
+    const patchDoc = [
+        { op: 'replace', path: '/fields/System.Title', value: test.title },
+        { op: 'replace', path: '/fields/Microsoft.VSTS.TCM.Steps', value: buildStepsXml(steps) },
+        { op: 'replace', path: '/fields/System.Tags', value: filteredTags },
+    ];
+    if (test.description) {
+        patchDoc.push({ op: 'replace', path: '/fields/System.Description', value: test.description });
+    }
+    await wit.updateWorkItem({}, patchDoc, id);
+}
+async function updateLocalFromAzure(client, id) {
+    return getTestCase(client, id);
+}
+async function addTestCaseToSuite(client, config, testCaseId, suiteId) {
+    const api = await client.getTestPlanApi();
+    await api.addTestCasesToSuite([{ workItem: { id: testCaseId } }], config.project, config.testPlan.id, suiteId);
+}
+async function addTestCaseToRootSuite(client, config, testCaseId) {
+    // Fetch the plan to get its root suite id
+    const api = await client.getTestPlanApi();
+    const plan = await api.getTestPlanById(config.project, config.testPlan.id);
+    const rootSuiteId = plan?.rootSuite?.id;
+    if (!rootSuiteId)
+        return;
+    await api.addTestCasesToSuite([{ workItem: { id: testCaseId } }], config.project, config.testPlan.id, rootSuiteId);
+}
+async function getTestCasesInSuite(client, config, suiteId) {
+    const api = await client.getTestPlanApi();
+    const wit = await client.getWitApi();
+    // Resolve suiteId
+    let resolvedSuiteId = suiteId ?? config.testPlan.suiteId;
+    if (!resolvedSuiteId) {
+        const plan = await api.getTestPlanById(config.project, config.testPlan.id);
+        resolvedSuiteId = plan?.rootSuite?.id;
+    }
+    if (!resolvedSuiteId)
+        return [];
+    const suiteTestCases = await api.getTestCaseList(config.project, config.testPlan.id, resolvedSuiteId);
+    if (!suiteTestCases?.length)
+        return [];
+    const fields = [
+        'System.Title',
+        'System.Description',
+        'Microsoft.VSTS.TCM.Steps',
+        'System.Tags',
+        'System.ChangedDate',
+        'System.AreaPath',
+        'System.IterationPath',
+    ];
+    const ids = suiteTestCases.map((tc) => tc.workItem?.id).filter(Boolean);
+    if (!ids.length)
+        return [];
+    const workItems = await wit.getWorkItems(ids, fields);
+    return (workItems ?? []).map((wi) => {
+        const f = wi.fields ?? {};
+        return {
+            id: wi.id,
+            title: f['System.Title'] ?? '',
+            description: f['System.Description'] ?? '',
+            steps: parseStepsXml(f['Microsoft.VSTS.TCM.Steps'] ?? ''),
+            tags: tagsFromString(f['System.Tags']),
+            changedDate: f['System.ChangedDate'],
+            areaPath: f['System.AreaPath'],
+            iterationPath: f['System.IterationPath'],
+        };
+    });
+}
+//# sourceMappingURL=test-cases.js.map

package/dist/azure/test-cases.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import 'dotenv/config';

package/dist/cli.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+"use strict";
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const chalk_1 = __importDefault(require("chalk"));
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const engine_1 = require("./sync/engine");
+// ─── CLI definition ───────────────────────────────────────────────────────────
+const program = new commander_1.Command();
+program
+    .name('ado-sync')
+    .description('Bidirectional sync between local test specs and Azure DevOps Test Cases')
+    .version('0.1.0');
+// Global option: --config / -c
+program.option('-c, --config <path>', 'Path to config file (default: ado-sync.json)');
+// ─── init ─────────────────────────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Generate a starter ado-sync.json config file')
+    .option('-o, --output <path>', 'Output path', 'ado-sync.json')
+    .action((opts) => {
+    const outPath = path.resolve(opts.output);
+    if (fs.existsSync(outPath)) {
+        console.error(chalk_1.default.red(`File already exists: ${outPath}`));
+        process.exit(1);
+    }
+    fs.writeFileSync(outPath, config_1.CONFIG_TEMPLATE_JSON, 'utf8');
+    console.log(chalk_1.default.green(`Created ${outPath}`));
+    console.log(chalk_1.default.dim('Edit the file with your Azure DevOps details, then run:'));
+    console.log(chalk_1.default.dim('  ado-sync push   (to create test cases from local specs)'));
+    console.log(chalk_1.default.dim('  ado-sync pull   (to pull updates from Azure DevOps)'));
+});
+// ─── push ─────────────────────────────────────────────────────────────────────
+program
+    .command('push')
+    .description('Push local test specs to Azure DevOps (create or update test cases)')
+    .option('--dry-run', 'Show what would change without making any modifications')
+    .option('--tags <expression>', 'Only sync scenarios matching this tag expression (e.g. "@smoke and not @wip")')
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    try {
+        const configPath = (0, config_1.resolveConfigPath)(globalOpts.config);
+        const config = (0, config_1.loadConfig)(configPath);
+        const configDir = path.dirname(configPath);
+        console.log(chalk_1.default.bold('ado-sync push'));
+        console.log(chalk_1.default.dim(`Config:  ${configPath}`));
+        console.log(chalk_1.default.dim(`Project: ${config.project}`));
+        console.log(chalk_1.default.dim(`Plan:    ${config.testPlan.id}`));
+        if (opts.dryRun)
+            console.log(chalk_1.default.yellow('Dry run — no changes will be made'));
+        if (opts.tags)
+            console.log(chalk_1.default.dim(`Tags:    ${opts.tags}`));
+        console.log('');
+        const results = await (0, engine_1.push)(config, configDir, { dryRun: opts.dryRun, tags: opts.tags });
+        printResults(results);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(err.message));
+        process.exit(1);
+    }
+});
+// ─── pull ─────────────────────────────────────────────────────────────────────
+program
+    .command('pull')
+    .description('Pull updates from Azure DevOps into local spec files')
+    .option('--dry-run', 'Show what would change without modifying local files')
+    .option('--tags <expression>', 'Only sync scenarios matching this tag expression (e.g. "@smoke and not @wip")')
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    try {
+        const configPath = (0, config_1.resolveConfigPath)(globalOpts.config);
+        const config = (0, config_1.loadConfig)(configPath);
+        const configDir = path.dirname(configPath);
+        console.log(chalk_1.default.bold('ado-sync pull'));
+        console.log(chalk_1.default.dim(`Config:  ${configPath}`));
+        if (opts.dryRun)
+            console.log(chalk_1.default.yellow('Dry run — no changes will be made'));
+        if (opts.tags)
+            console.log(chalk_1.default.dim(`Tags:    ${opts.tags}`));
+        console.log('');
+        const results = await (0, engine_1.pull)(config, configDir, { dryRun: opts.dryRun, tags: opts.tags });
+        printResults(results);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(err.message));
+        process.exit(1);
+    }
+});
+// ─── status ───────────────────────────────────────────────────────────────────
+program
+    .command('status')
+    .description('Show diff between local specs and Azure DevOps without making changes')
+    .option('--tags <expression>', 'Only check scenarios matching this tag expression')
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    try {
+        const configPath = (0, config_1.resolveConfigPath)(globalOpts.config);
+        const config = (0, config_1.loadConfig)(configPath);
+        const configDir = path.dirname(configPath);
+        console.log(chalk_1.default.bold('ado-sync status'));
+        console.log(chalk_1.default.dim(`Config: ${configPath}`));
+        if (opts.tags)
+            console.log(chalk_1.default.dim(`Tags:   ${opts.tags}`));
+        console.log('');
+        const results = await (0, engine_1.status)(config, configDir, { tags: opts.tags });
+        printResults(results);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(err.message));
+        process.exit(1);
+    }
+});
+// ─── Output helpers ───────────────────────────────────────────────────────────
+function printResults(results) {
+    const counts = { created: 0, updated: 0, pulled: 0, skipped: 0, conflict: 0, error: 0 };
+    for (const r of results) {
+        counts[r.action]++;
+        const idStr = r.azureId ? chalk_1.default.dim(` [#${r.azureId}]`) : '';
+        const detailStr = r.detail ? chalk_1.default.dim(` — ${r.detail}`) : '';
+        const filePart = chalk_1.default.dim(path.relative(process.cwd(), r.filePath) + ':');
+        switch (r.action) {
+            case 'created':
+                console.log(`${chalk_1.default.green('+')} ${filePart} ${r.title}${idStr}`);
+                break;
+            case 'updated':
+                console.log(`${chalk_1.default.blue('~')} ${filePart} ${r.title}${idStr}`);
+                break;
+            case 'pulled':
+                console.log(`${chalk_1.default.cyan('↓')} ${filePart} ${r.title}${idStr}${detailStr}`);
+                break;
+            case 'skipped':
+                console.log(`${chalk_1.default.dim('=')} ${filePart} ${chalk_1.default.dim(r.title)}${idStr}`);
+                break;
+            case 'conflict':
+                console.log(`${chalk_1.default.yellow('!')} ${filePart} ${r.title}${idStr}${detailStr}`);
+                break;
+            case 'error':
+                console.log(`${chalk_1.default.red('✗')} ${filePart} ${r.title}${idStr}${chalk_1.default.red(detailStr)}`);
+                break;
+        }
+    }
+    console.log('');
+    const summary = [
+        counts.created && chalk_1.default.green(`${counts.created} created`),
+        counts.updated && chalk_1.default.blue(`${counts.updated} updated`),
+        counts.pulled && chalk_1.default.cyan(`${counts.pulled} pulled`),
+        counts.skipped && chalk_1.default.dim(`${counts.skipped} skipped`),
+        counts.conflict && chalk_1.default.yellow(`${counts.conflict} conflicts`),
+        counts.error && chalk_1.default.red(`${counts.error} errors`),
+    ].filter(Boolean).join(chalk_1.default.dim('  '));
+    console.log(summary || chalk_1.default.dim('Nothing to sync.'));
+}
+// ─── Run ─────────────────────────────────────────────────────────────────────
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import { SyncConfig } from './types';
+export declare function resolveConfigPath(explicitPath?: string): string;
+export declare function loadConfig(configPath: string): SyncConfig;
+export declare const CONFIG_TEMPLATE_JSON: string;

package/dist/config.js

@@ -0,0 +1,129 @@
+"use strict";
+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.CONFIG_TEMPLATE_JSON = void 0;
+exports.resolveConfigPath = resolveConfigPath;
+exports.loadConfig = loadConfig;
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const path = __importStar(require("path"));
+const CONFIG_FILENAMES = ['ado-sync.json', 'ado-sync.yml', 'ado-sync.yaml'];
+function resolveConfigPath(explicitPath) {
+    if (explicitPath) {
+        const abs = path.resolve(explicitPath);
+        if (!fs.existsSync(abs))
+            throw new Error(`Config file not found: ${abs}`);
+        return abs;
+    }
+    for (const name of CONFIG_FILENAMES) {
+        const candidate = path.resolve(process.cwd(), name);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    throw new Error(`No config file found. Create one of: ${CONFIG_FILENAMES.join(', ')}\n` +
+        `Run 'ado-sync init' to generate a template.`);
+}
+function loadConfig(configPath) {
+    const raw = fs.readFileSync(configPath, 'utf8');
+    const ext = path.extname(configPath).toLowerCase();
+    let parsed;
+    if (ext === '.json') {
+        parsed = JSON.parse(raw);
+    }
+    else {
+        parsed = yaml.load(raw);
+    }
+    const cfg = parsed;
+    // Expand env var tokens like "$MY_TOKEN"
+    if (cfg.auth?.token?.startsWith('$')) {
+        const envKey = cfg.auth.token.slice(1);
+        const envVal = process.env[envKey];
+        if (!envVal) {
+            throw new Error(`Environment variable '${envKey}' (referenced in auth.token) is not set.`);
+        }
+        cfg.auth.token = envVal;
+    }
+    validateConfig(cfg, configPath);
+    // Default values
+    cfg.sync = cfg.sync ?? {};
+    cfg.sync.tagPrefix = cfg.sync.tagPrefix ?? 'tc';
+    return cfg;
+}
+function validateConfig(cfg, filePath) {
+    const err = (msg) => {
+        throw new Error(`Config error in ${filePath}: ${msg}`);
+    };
+    if (!cfg.orgUrl)
+        err('"orgUrl" is required');
+    if (!cfg.project)
+        err('"project" is required');
+    if (!cfg.auth?.type)
+        err('"auth.type" is required (pat | accessToken | managedIdentity)');
+    if (cfg.auth.type !== 'managedIdentity' && !cfg.auth.token) {
+        err('"auth.token" is required for auth type "' + cfg.auth.type + '"');
+    }
+    if (cfg.auth.type === 'managedIdentity' && !cfg.auth.applicationIdURI) {
+        err('"auth.applicationIdURI" is required when auth.type is "managedIdentity"');
+    }
+    if (!cfg.testPlan?.id)
+        err('"testPlan.id" is required');
+    if (!cfg.local?.type)
+        err('"local.type" is required (gherkin | markdown)');
+    if (!cfg.local?.include)
+        err('"local.include" is required');
+}
+exports.CONFIG_TEMPLATE_JSON = JSON.stringify({
+    orgUrl: 'https://dev.azure.com/YOUR_ORG',
+    project: 'YOUR_PROJECT',
+    auth: {
+        type: 'pat',
+        token: '$AZURE_DEVOPS_TOKEN',
+    },
+    testPlan: {
+        id: 0,
+        suiteId: 0,
+    },
+    local: {
+        type: 'gherkin',
+        include: 'specs/**/*.feature',
+        exclude: [],
+    },
+    sync: {
+        tagPrefix: 'tc',
+        areaPath: '',
+        iterationPath: '',
+    },
+}, null, 2);
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/parsers/gherkin.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Gherkin / Cucumber .feature file parser.
+ *
+ * Uses the modern @cucumber/gherkin generateMessages() API (same approach as
+ * playwright-bdd). This produces both the GherkinDocument (AST) and Pickles
+ * (compiled, example-substituted scenarios) in a single pass.
+ *
+ * Pickles are the canonical unit of work — they already have:
+ *   - Example values substituted in titles and step text
+ *   - Background steps merged into every scenario
+ *   - Tags inherited from Feature + Scenario + Examples blocks
+ *   - Step type (Context/Action/Outcome) instead of keyword
+ *
+ * ID tag convention:  @tc:12345  (prefix configurable via sync.tagPrefix)
+ *
+ * Path-based auto-tagging:
+ *   Directory segments prefixed with @ are added as tags automatically.
+ *   e.g.  specs/@smoke/@regression/login.feature  →  tags: ['smoke', 'regression']
+ */
+import { ParsedTest } from '../types';
+/** Extract Azure Test Case ID from a list of tag names. e.g. ['tc:123', 'smoke'] → 123 */
+export declare function extractAzureId(tags: string[], tagPrefix: string): number | undefined;
+/**
+ * Extract auto-tags from directory segments that start with '@'.
+ *
+ * Given  /project/specs/@smoke/@regression/login.feature
+ * returns ['smoke', 'regression']
+ */
+export declare function extractPathTags(filePath: string): string[];
+export declare function parseGherkinFile(filePath: string, tagPrefix: string): ParsedTest[];