ado-sync 0.1.2

package/dist/sync/engine.js

@@ -0,0 +1,296 @@
+"use strict";
+/**
+ * Sync engine — orchestrates push, pull, and status operations.
+ */
+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 });
+exports.push = push;
+exports.pull = pull;
+exports.status = status;
+const tag_expressions_1 = __importDefault(require("@cucumber/tag-expressions"));
+const fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+const client_1 = require("../azure/client");
+const test_cases_1 = require("../azure/test-cases");
+const gherkin_1 = require("../parsers/gherkin");
+const markdown_1 = require("../parsers/markdown");
+const writeback_1 = require("./writeback");
+// ─── Tag filtering ────────────────────────────────────────────────────────────
+/**
+ * Returns true when the test's tags satisfy the given tag expression.
+ * Expression syntax mirrors Cucumber:  "@smoke and not @wip"
+ * Tags in ParsedTest are stored without the leading @.
+ * The expression evaluator expects them with @, so we re-add it here.
+ */
+function matchesTags(test, expression) {
+    const node = (0, tag_expressions_1.default)(expression);
+    // Tags in ParsedTest have no leading '@'; tag-expressions evaluator needs them with '@'
+    const tagsWithAt = test.tags.map((t) => (t.startsWith('@') ? t : `@${t}`));
+    return node.evaluate(tagsWithAt);
+}
+// ─── File discovery ───────────────────────────────────────────────────────────
+async function discoverFiles(config, configDir) {
+    const patterns = Array.isArray(config.local.include)
+        ? config.local.include
+        : [config.local.include];
+    const excludes = config.local.exclude
+        ? Array.isArray(config.local.exclude)
+            ? config.local.exclude
+            : [config.local.exclude]
+        : [];
+    const all = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            cwd: configDir,
+            absolute: true,
+            ignore: excludes,
+        });
+        all.push(...matches);
+    }
+    return [...new Set(all)].sort();
+}
+// ─── Local file parsing ───────────────────────────────────────────────────────
+function parseLocalFiles(filePaths, config, tagsFilter) {
+    const tagPrefix = config.sync?.tagPrefix ?? 'tc';
+    const results = [];
+    for (const fp of filePaths) {
+        try {
+            const tests = config.local.type === 'gherkin'
+                ? (0, gherkin_1.parseGherkinFile)(fp, tagPrefix)
+                : (0, markdown_1.parseMarkdownFile)(fp, tagPrefix);
+            for (const t of tests) {
+                if (tagsFilter && !matchesTags(t, tagsFilter))
+                    continue;
+                results.push(t);
+            }
+        }
+        catch (err) {
+            console.warn(`  [warn] Failed to parse ${fp}: ${err.message}`);
+        }
+    }
+    return results;
+}
+// ─── Push ─────────────────────────────────────────────────────────────────────
+async function push(config, configDir, opts = {}) {
+    const files = await discoverFiles(config, configDir);
+    const tests = parseLocalFiles(files, config, opts.tags);
+    const client = await client_1.AzureClient.create(config);
+    const tagPrefix = config.sync?.tagPrefix ?? 'tc';
+    const results = [];
+    for (const test of tests) {
+        if (test.azureId) {
+            try {
+                const remote = await (0, test_cases_1.getTestCase)(client, test.azureId);
+                if (!remote) {
+                    results.push({
+                        action: 'error',
+                        filePath: test.filePath,
+                        title: test.title,
+                        azureId: test.azureId,
+                        detail: `Test case #${test.azureId} not found in Azure DevOps`,
+                    });
+                    continue;
+                }
+                const localStepsText = test.steps.map((s) => s.keyword + ' ' + s.text).join('\n');
+                const remoteStepsText = remote.steps.map((s) => s.action).join('\n');
+                const titleChanged = remote.title !== test.title;
+                const stepsChanged = localStepsText !== remoteStepsText;
+                if (!titleChanged && !stepsChanged) {
+                    results.push({ action: 'skipped', filePath: test.filePath, title: test.title, azureId: test.azureId });
+                    continue;
+                }
+                if (!opts.dryRun) {
+                    await (0, test_cases_1.updateTestCase)(client, test.azureId, test, config);
+                }
+                results.push({ action: 'updated', filePath: test.filePath, title: test.title, azureId: test.azureId });
+            }
+            catch (err) {
+                results.push({ action: 'error', filePath: test.filePath, title: test.title, azureId: test.azureId, detail: err.message });
+            }
+        }
+        else {
+            try {
+                let newId;
+                if (!opts.dryRun) {
+                    newId = await (0, test_cases_1.createTestCase)(client, test, config);
+                    (0, writeback_1.writebackId)(test, newId, config.local.type, tagPrefix);
+                }
+                results.push({ action: 'created', filePath: test.filePath, title: test.title, azureId: newId });
+            }
+            catch (err) {
+                results.push({ action: 'error', filePath: test.filePath, title: test.title, detail: err.message });
+            }
+        }
+    }
+    return results;
+}
+// ─── Pull ─────────────────────────────────────────────────────────────────────
+async function pull(config, configDir, opts = {}) {
+    const files = await discoverFiles(config, configDir);
+    const tests = parseLocalFiles(files, config, opts.tags);
+    const client = await client_1.AzureClient.create(config);
+    const results = [];
+    const linked = tests.filter((t) => t.azureId !== undefined);
+    for (const test of linked) {
+        try {
+            const remote = await (0, test_cases_1.getTestCase)(client, test.azureId);
+            if (!remote) {
+                results.push({
+                    action: 'error',
+                    filePath: test.filePath,
+                    title: test.title,
+                    azureId: test.azureId,
+                    detail: `Test case #${test.azureId} not found in Azure DevOps`,
+                });
+                continue;
+            }
+            const titleChanged = remote.title !== test.title;
+            const remoteStepsText = remote.steps.map((s) => s.action + '|' + s.expected).join('\n');
+            const localStepsText = test.steps.map((s) => s.keyword + ' ' + s.text + '|' + (s.expected ?? '')).join('\n');
+            const stepsChanged = remoteStepsText !== localStepsText;
+            if (!titleChanged && !stepsChanged) {
+                results.push({ action: 'skipped', filePath: test.filePath, title: test.title, azureId: test.azureId });
+                continue;
+            }
+            if (!opts.dryRun) {
+                applyRemoteToLocal(test, remote.title, remote.steps.map((s) => ({ keyword: 'Step', text: s.action, expected: s.expected })), config.local.type);
+            }
+            results.push({
+                action: 'pulled',
+                filePath: test.filePath,
+                title: remote.title,
+                azureId: test.azureId,
+                detail: [titleChanged && 'title', stepsChanged && 'steps'].filter(Boolean).join(', ') + ' changed',
+            });
+        }
+        catch (err) {
+            results.push({ action: 'error', filePath: test.filePath, title: test.title, azureId: test.azureId, detail: err.message });
+        }
+    }
+    return results;
+}
+// ─── Status ───────────────────────────────────────────────────────────────────
+async function status(config, configDir, opts = {}) {
+    return push(config, configDir, { dryRun: true, tags: opts.tags });
+}
+// ─── Apply remote changes to local file ───────────────────────────────────────
+function applyRemoteToLocal(test, newTitle, newSteps, localType) {
+    if (localType === 'gherkin') {
+        applyRemoteToGherkin(test, newTitle, newSteps);
+    }
+    else {
+        applyRemoteToMarkdown(test, newTitle, newSteps);
+    }
+}
+function applyRemoteToGherkin(test, newTitle, newSteps) {
+    const raw = fs.readFileSync(test.filePath, 'utf8');
+    const lines = raw.split('\n');
+    const scenarioLineIdx = test.line - 1;
+    lines[scenarioLineIdx] = lines[scenarioLineIdx].replace(/^(\s*Scenario(?:\s+Outline)?:\s*)(.*)$/, `$1${newTitle}`);
+    const stepStart = scenarioLineIdx + 1;
+    let stepEnd = stepStart;
+    while (stepEnd < lines.length) {
+        const l = lines[stepEnd].trim();
+        if (!l || /^(Scenario|Feature|Background|Examples|@)/.test(l) || /^---/.test(l))
+            break;
+        stepEnd++;
+    }
+    const stepLines = newSteps.map((s) => `    ${s.keyword} ${s.text}`);
+    lines.splice(stepStart, stepEnd - stepStart, ...stepLines);
+    fs.writeFileSync(test.filePath, lines.join('\n'), 'utf8');
+}
+function applyRemoteToMarkdown(test, newTitle, newSteps) {
+    const raw = fs.readFileSync(test.filePath, 'utf8');
+    const lines = raw.split('\n');
+    const headingLineIdx = test.line - 1;
+    lines[headingLineIdx] = lines[headingLineIdx].replace(/^(###\s+(?:\d+\.\s+)?)(.*)$/, `$1${newTitle}`);
+    const STEPS_RE = /^steps\s*:/i;
+    const EXPECTED_RE = /^expected\s+results?\s*:/i;
+    const SEPARATOR_RE = /^---+\s*$/;
+    const HEADING_RE = /^#{1,6}\s/;
+    let stepsStart = -1;
+    let stepsEnd = -1;
+    let expectedStart = -1;
+    for (let i = headingLineIdx + 1; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (HEADING_RE.test(lines[i]) || SEPARATOR_RE.test(trimmed)) {
+            if (stepsStart !== -1 && stepsEnd === -1)
+                stepsEnd = i;
+            break;
+        }
+        if (STEPS_RE.test(trimmed)) {
+            stepsStart = i;
+            continue;
+        }
+        if (EXPECTED_RE.test(trimmed)) {
+            if (stepsEnd === -1 && stepsStart !== -1)
+                stepsEnd = i;
+            expectedStart = i;
+            continue;
+        }
+    }
+    const newStepLines = newSteps.map((s, idx) => `${idx + 1}. ${s.text}`);
+    if (stepsStart !== -1 && stepsEnd !== -1) {
+        lines.splice(stepsStart, stepsEnd - stepsStart, 'Steps:', ...newStepLines);
+    }
+    // Recalculate after splice
+    const updatedLines = lines.join('\n').split('\n');
+    let newExpStart = -1;
+    let newExpEnd = -1;
+    if (expectedStart !== -1) {
+        for (let i = headingLineIdx + 1; i < updatedLines.length; i++) {
+            const trimmed = updatedLines[i].trim();
+            if (HEADING_RE.test(updatedLines[i]) || SEPARATOR_RE.test(trimmed)) {
+                if (newExpStart !== -1 && newExpEnd === -1)
+                    newExpEnd = i;
+                break;
+            }
+            if (EXPECTED_RE.test(trimmed)) {
+                newExpStart = i;
+                continue;
+            }
+        }
+        const lastExpected = [...newSteps].reverse().find((s) => s.expected)?.expected;
+        if (newExpStart !== -1 && newExpEnd !== -1 && lastExpected) {
+            const expLines = lastExpected.split('\n').map((l) => `- ${l.trim()}`).filter((l) => l.length > 2);
+            updatedLines.splice(newExpStart, newExpEnd - newExpStart, 'Expected results:', ...expLines);
+        }
+    }
+    fs.writeFileSync(test.filePath, updatedLines.join('\n'), 'utf8');
+}
+//# sourceMappingURL=engine.js.map

package/dist/sync/engine.js.map

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

package/dist/sync/writeback.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ID writeback — writes the Azure DevOps Test Case ID back to the local file
+ * after a test case is created, so subsequent syncs can match them.
+ *
+ * Gherkin strategy:
+ *   Inserts (or replaces) a  @{tagPrefix}:12345  tag line directly above the Scenario line.
+ *   Default with tagPrefix "tc":  @tc:12345
+ *
+ * Markdown strategy:
+ *   Inserts (or replaces) a  <!-- {tagPrefix}: 12345 -->  comment on the line
+ *   immediately following the ### heading.
+ *   Default with tagPrefix "tc":  <!-- tc: 12345 -->
+ */
+import { ParsedTest } from '../types';
+/**
+ * Write (or update) the @tc:ID tag in a .feature file for a given scenario.
+ *
+ * Strategy:
+ *  1. Find the scenario's line (1-based).
+ *  2. Look at lines above it for an existing @tc tag line.
+ *  3. If found, replace the tag in place.
+ *  4. If not found, insert a new tag line directly above the Scenario keyword.
+ */
+export declare function writebackGherkin(test: ParsedTest, id: number, tagPrefix: string): void;
+/**
+ * Write (or update) the <!-- {tagPrefix}: ID --> comment in a .md file
+ * for a given scenario heading.
+ *
+ * Strategy:
+ *  1. Find the ### heading line (1-based).
+ *  2. Scan the next ~15 lines for an existing comment.
+ *  3. If found, replace it.
+ *  4. If not found, insert immediately after the heading line.
+ */
+export declare function writebackMarkdown(test: ParsedTest, id: number, tagPrefix: string): void;
+export declare function writebackId(test: ParsedTest, id: number, localType: 'gherkin' | 'markdown', tagPrefix: string): void;

package/dist/sync/writeback.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * ID writeback — writes the Azure DevOps Test Case ID back to the local file
+ * after a test case is created, so subsequent syncs can match them.
+ *
+ * Gherkin strategy:
+ *   Inserts (or replaces) a  @{tagPrefix}:12345  tag line directly above the Scenario line.
+ *   Default with tagPrefix "tc":  @tc:12345
+ *
+ * Markdown strategy:
+ *   Inserts (or replaces) a  <!-- {tagPrefix}: 12345 -->  comment on the line
+ *   immediately following the ### heading.
+ *   Default with tagPrefix "tc":  <!-- tc: 12345 -->
+ */
+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.writebackGherkin = writebackGherkin;
+exports.writebackMarkdown = writebackMarkdown;
+exports.writebackId = writebackId;
+const fs = __importStar(require("fs"));
+// ─── Gherkin writeback ────────────────────────────────────────────────────────
+/**
+ * Write (or update) the @tc:ID tag in a .feature file for a given scenario.
+ *
+ * Strategy:
+ *  1. Find the scenario's line (1-based).
+ *  2. Look at lines above it for an existing @tc tag line.
+ *  3. If found, replace the tag in place.
+ *  4. If not found, insert a new tag line directly above the Scenario keyword.
+ */
+function writebackGherkin(test, id, tagPrefix) {
+    const raw = fs.readFileSync(test.filePath, 'utf8');
+    const lines = raw.split('\n');
+    const scenarioLineIdx = test.line - 1; // convert to 0-based
+    const tagToken = `@${tagPrefix}:${id}`;
+    const tagLineRe = new RegExp(`@${tagPrefix}:\\d+`);
+    // Walk upward from the scenario line to find an existing tag line
+    let replacedInline = false;
+    for (let i = scenarioLineIdx - 1; i >= 0 && i >= scenarioLineIdx - 5; i--) {
+        if (tagLineRe.test(lines[i])) {
+            // Replace the existing tc tag on this line, preserve other tags
+            lines[i] = lines[i].replace(tagLineRe, tagToken);
+            replacedInline = true;
+            break;
+        }
+    }
+    if (!replacedInline) {
+        // Insert a new tag line above the Scenario line
+        // Detect indentation of the scenario line
+        const scenarioLine = lines[scenarioLineIdx] ?? '';
+        const indentMatch = scenarioLine.match(/^(\s*)/);
+        const indent = indentMatch ? indentMatch[1] : '';
+        lines.splice(scenarioLineIdx, 0, `${indent}${tagToken}`);
+    }
+    fs.writeFileSync(test.filePath, lines.join('\n'), 'utf8');
+}
+// ─── Markdown writeback ───────────────────────────────────────────────────────
+/**
+ * Write (or update) the <!-- {tagPrefix}: ID --> comment in a .md file
+ * for a given scenario heading.
+ *
+ * Strategy:
+ *  1. Find the ### heading line (1-based).
+ *  2. Scan the next ~15 lines for an existing comment.
+ *  3. If found, replace it.
+ *  4. If not found, insert immediately after the heading line.
+ */
+function writebackMarkdown(test, id, tagPrefix) {
+    const raw = fs.readFileSync(test.filePath, 'utf8');
+    const lines = raw.split('\n');
+    const headingLineIdx = test.line - 1; // 0-based
+    const comment = `<!-- ${tagPrefix}: ${id} -->`;
+    const existingRe = new RegExp(`<!--\\s*${tagPrefix}\\s*:\\s*\\d+\\s*-->`, 'i');
+    // Scan forward for an existing comment (up to 15 lines after heading)
+    const scanEnd = Math.min(headingLineIdx + 15, lines.length);
+    let found = false;
+    for (let i = headingLineIdx + 1; i < scanEnd; i++) {
+        if (existingRe.test(lines[i])) {
+            lines[i] = comment;
+            found = true;
+            break;
+        }
+        // Stop at the next heading or separator
+        if (/^#{1,6}\s/.test(lines[i]) || /^---+\s*$/.test(lines[i]))
+            break;
+    }
+    if (!found) {
+        // Insert on the line immediately after the heading
+        lines.splice(headingLineIdx + 1, 0, comment);
+    }
+    fs.writeFileSync(test.filePath, lines.join('\n'), 'utf8');
+}
+// ─── Dispatcher ──────────────────────────────────────────────────────────────
+function writebackId(test, id, localType, tagPrefix) {
+    if (localType === 'gherkin') {
+        writebackGherkin(test, id, tagPrefix);
+    }
+    else {
+        writebackMarkdown(test, id, tagPrefix);
+    }
+}
+//# sourceMappingURL=writeback.js.map

package/dist/sync/writeback.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Shared types for azure-test-sync
+ */
+export type AuthType = 'pat' | 'accessToken' | 'managedIdentity';
+export interface SyncConfig {
+    /** Azure DevOps organisation URL, e.g. https://dev.azure.com/myorg */
+    orgUrl: string;
+    /** Azure DevOps project name */
+    project: string;
+    /** Authentication */
+    auth: {
+        type: AuthType;
+        /** Personal Access Token (or env var name prefixed with $) */
+        token?: string;
+        /** Required when type === 'managedIdentity' */
+        applicationIdURI?: string;
+    };
+    /** Target test plan / suite */
+    testPlan: {
+        id: number;
+        /** Root suite to create new test cases under. Defaults to plan root suite. */
+        suiteId?: number;
+    };
+    /** Local spec sources */
+    local: {
+        /** 'gherkin' for .feature files, 'markdown' for .md spec files */
+        type: 'gherkin' | 'markdown';
+        /** Glob pattern(s) relative to config file location */
+        include: string | string[];
+        /** Glob pattern(s) to exclude */
+        exclude?: string | string[];
+    };
+    /** Sync behaviour */
+    sync?: {
+        /** Prefix used in tags/comments to store the Azure test case ID. Default: 'tc' */
+        tagPrefix?: string;
+        /** Field name in Azure used as test title. Default: 'System.Title' */
+        titleField?: string;
+        /** Default area path for new test cases */
+        areaPath?: string;
+        /** Default iteration path for new test cases */
+        iterationPath?: string;
+    };
+}
+export interface ParsedStep {
+    keyword: string;
+    text: string;
+    expected?: string;
+}
+export interface ParsedTest {
+    /** Absolute path to the local file */
+    filePath: string;
+    /** Title of the test (Scenario title / Markdown heading) */
+    title: string;
+    /** Optional description / background text */
+    description?: string;
+    /** Steps */
+    steps: ParsedStep[];
+    /** Tags collected from the file (Gherkin tags or markdown metadata) */
+    tags: string[];
+    /** Azure DevOps Test Case ID if already synced, otherwise undefined */
+    azureId?: number;
+    /** Line number in the file where the scenario / heading starts (1-based) */
+    line: number;
+}
+export interface AzureTestCase {
+    id: number;
+    title: string;
+    description?: string;
+    steps: AzureStep[];
+    tags: string[];
+    /** ISO timestamp of last change in Azure */
+    changedDate?: string;
+    areaPath?: string;
+    iterationPath?: string;
+}
+export interface AzureStep {
+    action: string;
+    expected: string;
+}
+export type SyncAction = 'created' | 'updated' | 'skipped' | 'conflict' | 'pulled' | 'error';
+export interface SyncResult {
+    action: SyncAction;
+    filePath: string;
+    title: string;
+    azureId?: number;
+    detail?: string;
+}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared types for azure-test-sync
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "ado-sync",
+  "version": "0.1.2",
+  "description": "Bidirectional sync between local test specs (Cucumber/Markdown) and Azure DevOps Test Cases",
+  "bin": {
+    "ado-sync": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "dev": "ts-node src/cli.ts",
+    "lint": "eslint src --ext .ts --quiet",
+    "lint:fix": "eslint src --ext .ts --fix --quiet",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "azure-devops",
+    "test-sync",
+    "cucumber",
+    "gherkin",
+    "playwright",
+    "specsync"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PavanMudigonda/ado-sync"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@azure/identity": "^4.12.0",
+    "@cucumber/gherkin": "^29.0.0",
+    "@cucumber/messages": "^26.0.0",
+    "@cucumber/tag-expressions": "^6.2.0",
+    "azure-devops-node-api": "^15.1.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5",
+    "fast-xml-parser": "^4.4.1",
+    "glob": "^11.0.0",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.16.5",
+    "@typescript-eslint/eslint-plugin": "^8.41.0",
+    "@typescript-eslint/parser": "^8.41.0",
+    "eslint": "^9.34.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "prettier": "^3.6.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  }
+}