ado-sync 0.1.65 → 0.1.68

package/dist/__tests__/regressions.test.js

@@ -41,9 +41,13 @@ const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const node_test_1 = __importDefault(require("node:test"));
+const summarizer_1 = require("../ai/summarizer");
 const client_1 = require("../azure/client");
 const test_cases_1 = require("../azure/test-cases");
+const cli_diagnostics_1 = require("../cli-diagnostics");
+const config_1 = require("../config");
 const id_markers_1 = require("../id-markers");
+const id_markers_2 = require("../id-markers");
 const gherkin_1 = require("../parsers/gherkin");
 const javascript_1 = require("../parsers/javascript");
 const engine_1 = require("../sync/engine");
@@ -71,6 +75,64 @@ function makeParsedTest(overrides = {}) {
         ...overrides,
     };
 }
+function withTemporaryEnv(vars, fn) {
+    const previous = {};
+    for (const [key, value] of Object.entries(vars)) {
+        previous[key] = process.env[key];
+        if (value === undefined)
+            delete process.env[key];
+        else
+            process.env[key] = value;
+    }
+    try {
+        fn();
+    }
+    finally {
+        for (const [key, value] of Object.entries(previous)) {
+            if (value === undefined)
+                delete process.env[key];
+            else
+                process.env[key] = value;
+        }
+    }
+}
+function withCleanAiDetectionEnv(vars, fn) {
+    withTemporaryEnv({
+        ANTHROPIC_API_KEY: undefined,
+        OPENAI_API_KEY: undefined,
+        GITHUB_TOKEN: undefined,
+        CLAUDE_CODE: undefined,
+        CLAUDE_CONTEXT: undefined,
+        CODEX: undefined,
+        OPENAI_CODEX: undefined,
+        CODEX_CLI: undefined,
+        VISUAL_STUDIO_AGENT_MODE: undefined,
+        VISUAL_STUDIO_COPILOT_AGENT_MODE: undefined,
+        VS_COPILOT_AGENT_MODE: undefined,
+        COPILOT_AGENT_MODE: undefined,
+        CURSOR_SESSION_ID: undefined,
+        CURSOR_TRACE_ID: undefined,
+        WINDSURF_SESSION_ID: undefined,
+        CLINE_TASK_ID: undefined,
+        CLINE_SESSION_ID: undefined,
+        ANTIGRAVITY_SESSION_ID: undefined,
+        AIDER: undefined,
+        AIDER_SESSION: undefined,
+        CONTINUE_SESSION_ID: undefined,
+        AUGMENT_SESSION_ID: undefined,
+        ROO_CODE_SESSION_ID: undefined,
+        TRAE_SESSION_ID: undefined,
+        AMAZON_Q_SESSION_ID: undefined,
+        AWS_Q_SESSION_ID: undefined,
+        AMP_SESSION_ID: undefined,
+        TERM_PROGRAM: undefined,
+        TERMINAL_EMULATOR: undefined,
+        IDEA_INITIAL_DIRECTORY: undefined,
+        __INTELLIJ_COMMAND_HISTFILE__: undefined,
+        PATH: '/usr/bin:/bin',
+        ...vars,
+    }, fn);
+}
 (0, node_test_1.default)('buildPushDiff flags expected-result-only step changes', () => {
     const config = makeConfig();
     const local = makeParsedTest();
@@ -95,6 +157,10 @@ function makeParsedTest(overrides = {}) {
             msg.includes('unexpected token');
     });
 });
+(0, node_test_1.default)('validatePushModeOptions rejects incompatible mode combinations', () => {
+    strict_1.default.throws(() => (0, engine_1.validatePushModeOptions)({ createOnly: true, linkOnly: true, updateOnly: false }), /Only one push mode can be used at a time/);
+    strict_1.default.throws(() => (0, engine_1.validatePushModeOptions)({ createOnly: false, linkOnly: true, updateOnly: true }), /Only one push mode can be used at a time/);
+});
 (0, node_test_1.default)('parseGherkinFile preserves doc-string block structure in description HTML', () => {
     const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-gherkin-docstring-'));
     const filePath = path.join(tempDir, 'sample.feature');
@@ -147,6 +213,261 @@ function makeParsedTest(overrides = {}) {
     strict_1.default.ok(updatePatch.some((p) => p.op === 'remove' && p.path === '/fields/Microsoft.VSTS.TCM.Parameters'));
     strict_1.default.ok(updatePatch.some((p) => p.op === 'remove' && p.path === '/fields/Microsoft.VSTS.TCM.LocalDataSource'));
 });
+(0, node_test_1.default)('updateTestCase adds deterministic ownership tag for tagged sync targets', async () => {
+    let updatePatch;
+    const config = makeConfig({
+        configurationKey: 'Smoke Suite',
+        syncTarget: { mode: 'tagged' },
+    });
+    const ownershipTag = (0, id_markers_1.getSyncTargetOwnershipTag)(config);
+    const wit = {
+        getWorkItem: async () => ({
+            fields: {
+                'System.Tags': 'smoke',
+            },
+        }),
+        updateWorkItem: async (_doc, patch) => {
+            updatePatch = patch;
+            return {};
+        },
+    };
+    const client = {
+        getWitApi: async () => wit,
+    };
+    await (0, test_cases_1.updateTestCase)(client, 99, makeParsedTest(), config);
+    strict_1.default.ok(updatePatch, 'expected updateWorkItem to be called');
+    const tagsPatch = updatePatch.find((patch) => patch.path === '/fields/System.Tags');
+    strict_1.default.ok(tagsPatch, 'expected System.Tags to be updated');
+    strict_1.default.match(tagsPatch.value, new RegExp(ownershipTag ?? ''));
+});
+(0, node_test_1.default)('loadConfig accepts declarative hierarchy definitions', () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-hierarchy-config-'));
+    const configPath = path.join(tempDir, 'ado-sync.json');
+    fs.writeFileSync(configPath, JSON.stringify({
+        orgUrl: 'https://dev.azure.com/example',
+        project: 'ExampleProject',
+        auth: { type: 'pat', token: 'token' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byFolder', rootSuite: 'Generated Specs' },
+        },
+        local: { type: 'gherkin', include: 'specs/**/*.feature' },
+    }, null, 2));
+    try {
+        const loaded = (0, config_1.loadConfig)(configPath);
+        strict_1.default.deepEqual(loaded.testPlan.hierarchy, { mode: 'byFolder', rootSuite: 'Generated Specs' });
+    }
+    finally {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('loadConfig accepts tag-driven hierarchy definitions', () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-hierarchy-by-tag-config-'));
+    const configPath = path.join(tempDir, 'ado-sync.json');
+    fs.writeFileSync(configPath, JSON.stringify({
+        orgUrl: 'https://dev.azure.com/example',
+        project: 'ExampleProject',
+        auth: { type: 'pat', token: 'token' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byTag', tagPrefix: 'suite', rootSuite: 'Generated Specs' },
+        },
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+    }, null, 2));
+    try {
+        const loaded = (0, config_1.loadConfig)(configPath);
+        strict_1.default.deepEqual(loaded.testPlan.hierarchy, { mode: 'byTag', tagPrefix: 'suite', rootSuite: 'Generated Specs' });
+    }
+    finally {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('loadConfig accepts level-rule hierarchy definitions and diagnostic output', () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-hierarchy-by-levels-config-'));
+    const configPath = path.join(tempDir, 'ado-sync.json');
+    fs.writeFileSync(configPath, JSON.stringify({
+        orgUrl: 'https://dev.azure.com/example',
+        project: 'ExampleProject',
+        auth: { type: 'pat', token: 'token' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: {
+                mode: 'byLevels',
+                rootSuite: 'Generated Specs',
+                levels: [
+                    { source: 'folder', index: 0 },
+                    { source: 'tag', tagPrefix: 'suite' },
+                ],
+            },
+        },
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        toolSettings: { outputLevel: 'diagnostic' },
+    }, null, 2));
+    try {
+        const loaded = (0, config_1.loadConfig)(configPath);
+        strict_1.default.deepEqual(loaded.testPlan.hierarchy, {
+            mode: 'byLevels',
+            rootSuite: 'Generated Specs',
+            levels: [
+                { source: 'folder', index: 0 },
+                { source: 'tag', tagPrefix: 'suite' },
+            ],
+        });
+        strict_1.default.equal(loaded.toolSettings?.outputLevel, 'diagnostic');
+    }
+    finally {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('getValidateDiagnosticItems summarizes effective validate context', () => {
+    strict_1.default.deepEqual((0, cli_diagnostics_1.getValidateDiagnosticItems)({
+        authType: 'pat',
+        localType: 'gherkin',
+        syncTargetMode: 'query',
+        planIds: [7, 9],
+        overrideCount: 2,
+    }), [
+        { label: 'Auth type', value: 'pat' },
+        { label: 'Local type', value: 'gherkin' },
+        { label: 'Sync target', value: 'query' },
+        { label: 'Plan IDs', value: '7, 9' },
+        { label: 'Overrides', value: '2' },
+    ]);
+});
+(0, node_test_1.default)('getStaleDiagnosticItems summarizes stale detection context', () => {
+    strict_1.default.deepEqual((0, cli_diagnostics_1.getStaleDiagnosticItems)({
+        syncTargetMode: 'tagged',
+        planIds: [5],
+        markerPrefix: 'tc',
+        ownershipTag: 'ado-sync:smoke-suite',
+        tagExpression: '@smoke',
+        staleCount: 3,
+        retireState: 'Closed',
+        dryRun: true,
+        overrideCount: 1,
+    }), [
+        { label: 'Sync target', value: 'tagged' },
+        { label: 'Plan ID', value: '5' },
+        { label: 'Marker prefix', value: 'tc' },
+        { label: 'Ownership tag', value: 'ado-sync:smoke-suite' },
+        { label: 'Tag filter', value: '@smoke' },
+        { label: 'Stale candidates', value: '3' },
+        { label: 'Retire state', value: 'Closed' },
+        { label: 'Dry run', value: 'yes' },
+        { label: 'Overrides', value: '1' },
+    ]);
+});
+(0, node_test_1.default)('getCoverageDiagnosticItems summarizes coverage context', () => {
+    strict_1.default.deepEqual((0, cli_diagnostics_1.getCoverageDiagnosticItems)({
+        localType: 'markdown',
+        syncTargetMode: 'suite',
+        tagExpression: '@smoke',
+        totalLocalSpecs: 12,
+        linkedSpecs: 9,
+        unlinkedSpecs: 3,
+        storiesReferenced: 5,
+        storiesCovered: 4,
+        storyPrefix: 'story',
+        failBelow: 80,
+        overrideCount: 1,
+    }), [
+        { label: 'Local type', value: 'markdown' },
+        { label: 'Sync target', value: 'suite' },
+        { label: 'Tag filter', value: '@smoke' },
+        { label: 'Total specs', value: '12' },
+        { label: 'Linked specs', value: '9' },
+        { label: 'Unlinked specs', value: '3' },
+        { label: 'Story prefix', value: 'story' },
+        { label: 'Stories referenced', value: '5' },
+        { label: 'Stories covered', value: '4' },
+        { label: 'Fail-below gate', value: '80%' },
+        { label: 'Overrides', value: '1' },
+    ]);
+});
+(0, node_test_1.default)('getTrendDiagnosticItems summarizes trend context', () => {
+    strict_1.default.deepEqual((0, cli_diagnostics_1.getTrendDiagnosticItems)({
+        days: 14,
+        maxRuns: 25,
+        topN: 7,
+        runNameFilter: 'nightly',
+        webhookType: 'teams',
+        failOnFlaky: true,
+        failBelow: 85,
+        runsAnalyzed: 12,
+        totalResults: 240,
+        flakyCount: 3,
+        failingCount: 7,
+        overrideCount: 2,
+    }), [
+        { label: 'Days', value: '14' },
+        { label: 'Max runs', value: '25' },
+        { label: 'Top-N', value: '7' },
+        { label: 'Run-name filter', value: 'nightly' },
+        { label: 'Webhook', value: 'teams' },
+        { label: 'Fail on flaky', value: 'yes' },
+        { label: 'Fail-below gate', value: '85%' },
+        { label: 'Runs analyzed', value: '12' },
+        { label: 'Results analyzed', value: '240' },
+        { label: 'Flaky tests', value: '3' },
+        { label: 'Top failing tests', value: '7' },
+        { label: 'Overrides', value: '2' },
+    ]);
+});
+(0, node_test_1.default)('getAcGateDiagnosticItems summarizes ac-gate context', () => {
+    strict_1.default.deepEqual((0, cli_diagnostics_1.getAcGateDiagnosticItems)({
+        selectorMode: 'area-path',
+        selectorValue: 'Project\\QA',
+        failMode: 'no-ac-only',
+        totalStories: 9,
+        passed: 6,
+        failed: 3,
+        noAc: 2,
+        noTc: 1,
+        overrideCount: 1,
+    }), [
+        { label: 'Selector mode', value: 'area-path' },
+        { label: 'Selector value', value: 'Project\\QA' },
+        { label: 'States', value: 'n/a' },
+        { label: 'Fail mode', value: 'no-ac-only' },
+        { label: 'Stories selected', value: '9' },
+        { label: 'Passed', value: '6' },
+        { label: 'Failed', value: '3' },
+        { label: 'Missing AC', value: '2' },
+        { label: 'Missing TCs', value: '1' },
+        { label: 'Overrides', value: '1' },
+    ]);
+});
+(0, node_test_1.default)('getOrCreateSuiteForFile anchors generated hierarchy under a named root suite', async () => {
+    const createdSuites = [];
+    let nextSuiteId = 100;
+    const client = {
+        getTestPlanApi: async () => ({
+            getTestSuitesForPlan: async () => [],
+            createTestSuite: async (suite) => {
+                createdSuites.push({ name: suite.name, parentSuiteId: suite.parentSuite.id });
+                return { id: nextSuiteId++ };
+            },
+        }),
+    };
+    const config = makeConfig({
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byFile', rootSuite: 'Generated Specs' },
+        },
+    });
+    const suiteId = await (0, test_cases_1.getOrCreateSuiteForFile)(client, config, '/repo/specs/auth/login.feature', '/repo', new Map());
+    strict_1.default.equal(suiteId, 103);
+    strict_1.default.deepEqual(createdSuites, [
+        { name: 'Generated Specs', parentSuiteId: 10 },
+        { name: 'specs', parentSuiteId: 100 },
+        { name: 'auth', parentSuiteId: 101 },
+        { name: 'login', parentSuiteId: 102 },
+    ]);
+});
 (0, node_test_1.default)('writebackDocComment preserves user-authored JSDoc and parser ignores ado-sync marker', async () => {
     const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-test-'));
     const filePath = path.join(tempDir, 'sample.test.ts');
@@ -211,6 +532,8 @@ function makeParsedTest(overrides = {}) {
         const summary = await (0, publish_results_1.publishTestResults)(config, tempDir);
         strict_1.default.equal(summary.runId, 77);
         strict_1.default.deepEqual(createRunModel.configurationIds, [9]);
+        strict_1.default.equal(summary.diagnostics?.configurationId, 9);
+        strict_1.default.equal(summary.diagnostics?.sources[0]?.format, 'junit');
     }
     finally {
         client_1.AzureClient.create = originalCreate;
@@ -271,6 +594,7 @@ function makeParsedTest(overrides = {}) {
         strict_1.default.equal(addedResultsPayload[0].testPlan.id, '12');
         strict_1.default.equal(addedResultsPayload[0].testCaseRevision, 7);
         strict_1.default.equal(addedResultsPayload[0].configuration.id, '9');
+        strict_1.default.deepEqual(summary.diagnostics?.plannedRun, { planId: 12, suiteId: 34, pointCount: 1 });
     }
     finally {
         client_1.AzureClient.create = originalCreate;
@@ -357,6 +681,665 @@ function makeParsedTest(overrides = {}) {
         fs.rmSync(tempDir, { recursive: true, force: true });
     }
 });
+(0, node_test_1.default)('push limits processing to requested source files and skips removed-case detection', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-source-file-'));
+    const selectedFilePath = path.join(tempDir, 'selected.md');
+    const skippedFilePath = path.join(tempDir, 'skipped.md');
+    fs.writeFileSync(selectedFilePath, ['### Selected case', '', 'Steps:', '1. Open the app', ''].join('\n'));
+    fs.writeFileSync(skippedFilePath, ['### Skipped case', '', 'Steps:', '1. Do not sync me', ''].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: '*.md' },
+    });
+    let suiteFetchCount = 0;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => {
+                suiteFetchCount++;
+                return [{ workItem: { id: 77 } }];
+            },
+            getTestPlanById: async () => ({ rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [{ id: 77, fields: { 'System.Title': 'Unrelated remote case', 'System.Tags': '' } }],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.push)(config, tempDir, { dryRun: true, sourceFiles: [selectedFilePath] });
+        strict_1.default.equal(suiteFetchCount, 0);
+        strict_1.default.ok(results.some((result) => result.action === 'created' && result.filePath === selectedFilePath));
+        strict_1.default.ok(!results.some((result) => result.filePath === skippedFilePath));
+        strict_1.default.ok(!results.some((result) => result.action === 'removed'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push create-only creates unlinked cases and skips linked updates and removed detection', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-create-only-'));
+    const filePath = path.join(tempDir, 'spec.md');
+    fs.writeFileSync(filePath, [
+        '### Existing case',
+        '@tc:55',
+        '',
+        'Steps:',
+        '1. Existing step',
+        '',
+        '---',
+        '',
+        '### New case',
+        '',
+        'Steps:',
+        '1. New step',
+        '',
+    ].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: '*.md' },
+    });
+    let suiteFetchCount = 0;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => {
+                suiteFetchCount++;
+                return [{ workItem: { id: 77 } }];
+            },
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [{ id: 77, fields: { 'System.Title': 'Unrelated remote case', 'System.Tags': '' } }],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.push)(config, tempDir, { dryRun: true, createOnly: true });
+        strict_1.default.equal(suiteFetchCount, 0);
+        strict_1.default.ok(results.some((result) => result.action === 'created' && result.title === 'New case'));
+        strict_1.default.ok(results.some((result) => result.action === 'skipped' && result.azureId === 55 && /create-only/.test(result.detail ?? '')));
+        strict_1.default.ok(!results.some((result) => result.action === 'removed'));
+        strict_1.default.ok(!results.some((result) => result.action === 'updated'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push link-only links unlinked cases by unique exact title match without creating or updating', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-link-only-'));
+    const filePath = path.join(tempDir, 'spec.md');
+    fs.writeFileSync(filePath, [
+        '### Already linked',
+        '@tc:55',
+        '',
+        'Steps:',
+        '1. Existing step',
+        '',
+        '---',
+        '',
+        '### Match me',
+        '',
+        'Steps:',
+        '1. Same title as remote',
+        '',
+    ].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: '*.md' },
+    });
+    let suiteFetchCount = 0;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => {
+                suiteFetchCount++;
+                return [{ workItem: { id: 88 } }, { workItem: { id: 99 } }];
+            },
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [
+                { id: 88, fields: { 'System.Title': 'Match me', 'System.Tags': '' } },
+                { id: 99, fields: { 'System.Title': 'Unrelated remote case', 'System.Tags': '' } },
+            ],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.push)(config, tempDir, { dryRun: true, linkOnly: true });
+        strict_1.default.equal(suiteFetchCount, 1);
+        strict_1.default.ok(results.some((result) => result.action === 'linked' && result.azureId === 88 && result.title === 'Match me'));
+        strict_1.default.ok(results.some((result) => result.action === 'skipped' && result.azureId === 55 && /link-only/.test(result.detail ?? '')));
+        strict_1.default.ok(!results.some((result) => result.action === 'created'));
+        strict_1.default.ok(!results.some((result) => result.action === 'updated'));
+        strict_1.default.ok(!results.some((result) => result.action === 'removed'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push link-only skips ambiguous exact title matches', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-link-ambiguous-'));
+    const filePath = path.join(tempDir, 'spec.md');
+    fs.writeFileSync(filePath, ['### Duplicate title', '', 'Steps:', '1. Step', ''].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: '*.md' },
+    });
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [{ workItem: { id: 90 } }, { workItem: { id: 91 } }],
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [
+                { id: 90, fields: { 'System.Title': 'Duplicate title', 'System.Tags': '' } },
+                { id: 91, fields: { 'System.Title': 'Duplicate title', 'System.Tags': '' } },
+            ],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.push)(config, tempDir, { dryRun: true, linkOnly: true });
+        strict_1.default.ok(results.some((result) => result.action === 'skipped' && /multiple title matches/.test(result.detail ?? '')));
+        strict_1.default.ok(!results.some((result) => result.action === 'linked'));
+        strict_1.default.ok(!results.some((result) => result.action === 'created'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push update-only updates linked cases and skips unlinked cases and removed detection', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-update-only-'));
+    const filePath = path.join(tempDir, 'spec.md');
+    fs.writeFileSync(filePath, [
+        '### Existing case',
+        '@tc:55',
+        '',
+        'Steps:',
+        '1. Updated local step',
+        '',
+        '---',
+        '',
+        '### New case',
+        '',
+        'Steps:',
+        '1. New step',
+        '',
+    ].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: '*.md' },
+    });
+    let suiteFetchCount = 0;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => {
+                suiteFetchCount++;
+                return [{ workItem: { id: 77 } }];
+            },
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+            addTestCasesToSuite: async () => undefined,
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [{
+                    id: 77,
+                    fields: {
+                        'System.Title': 'Unrelated remote case',
+                        'System.Tags': '',
+                    },
+                }],
+            getWorkItem: async (id) => ({
+                id,
+                fields: {
+                    'System.Title': 'Existing case',
+                    'System.Description': '',
+                    'Microsoft.VSTS.TCM.Steps': '<steps id="0" last="2"><step id="2" type="ValidateStep"><parameterizedString isformatted="true">&lt;DIV&gt;&lt;P&gt;Step Existing local step&lt;/P&gt;&lt;/DIV&gt;</parameterizedString><parameterizedString isformatted="true"></parameterizedString><description/></step></steps>',
+                    'System.Tags': '',
+                    'System.ChangedDate': '2026-05-01T00:00:00Z',
+                },
+            }),
+            updateWorkItem: async () => ({}),
+        }),
+    });
+    try {
+        const results = await (0, engine_1.push)(config, tempDir, { dryRun: true, updateOnly: true });
+        strict_1.default.equal(suiteFetchCount, 0);
+        strict_1.default.ok(results.some((result) => result.action === 'updated' && result.azureId === 55));
+        strict_1.default.ok(results.some((result) => result.action === 'skipped' && result.title === 'New case' && /update-only/.test(result.detail ?? '')));
+        strict_1.default.ok(!results.some((result) => result.action === 'created'));
+        strict_1.default.ok(!results.some((result) => result.action === 'removed'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push moves linked hierarchy-managed cases to the new generated suite when file path changes', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-hierarchy-move-'));
+    const oldRelativePath = 'specs/old/login.md';
+    const newRelativePath = 'specs/new/login.md';
+    const filePath = path.join(tempDir, newRelativePath);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, ['### Existing case', '@tc:55', '', 'Steps:', '1. Existing step', ''].join('\n'));
+    fs.writeFileSync(path.join(tempDir, '.ado-sync-state.json'), JSON.stringify({
+        55: {
+            title: 'Existing case',
+            stepsHash: 'cached-steps',
+            descriptionHash: 'cached-description',
+            remoteDescriptionHash: 'cached-remote-description',
+            changedDate: '2026-05-01T00:00:00Z',
+            filePath: path.join(tempDir, oldRelativePath),
+        },
+    }, null, 2));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byFolder' },
+        },
+    });
+    const addedToSuites = [];
+    const removedFromSuites = [];
+    const suites = [
+        { id: 101, name: 'specs', parentSuite: { id: 10 } },
+        { id: 102, name: 'old', parentSuite: { id: 101 } },
+    ];
+    let nextSuiteId = 103;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [],
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+            getTestSuitesForPlan: async () => suites,
+            createTestSuite: async (suite) => {
+                const created = { id: nextSuiteId++, name: suite.name, parentSuite: { id: suite.parentSuite.id } };
+                suites.push(created);
+                return created;
+            },
+            addTestCasesToSuite: async (_entries, _project, _planId, suiteId) => {
+                addedToSuites.push(suiteId);
+            },
+            removeTestCasesFromSuite: async (_project, _planId, suiteId, _testCaseIds) => {
+                removedFromSuites.push(suiteId);
+            },
+        }),
+        getWitApi: async () => ({
+            getWorkItem: async (id) => ({
+                id,
+                fields: {
+                    'System.Title': 'Existing case',
+                    'System.Description': '',
+                    'Microsoft.VSTS.TCM.Steps': '<steps id="0" last="2"><step id="2" type="ValidateStep"><parameterizedString isformatted="true">&lt;DIV&gt;&lt;P&gt;Step Existing step&lt;/P&gt;&lt;/DIV&gt;</parameterizedString><parameterizedString isformatted="true"></parameterizedString><description/></step></steps>',
+                    'System.Tags': '',
+                    'System.ChangedDate': '2026-05-01T00:00:00Z',
+                },
+            }),
+            updateWorkItem: async () => ({})
+        }),
+    });
+    try {
+        const results = await (0, engine_1.push)(config, tempDir, { dryRun: false });
+        strict_1.default.ok(results.some((result) => result.action === 'updated' && result.azureId === 55 && result.changedFields?.includes('suite') && result.targetSuitePath === 'specs / new' && result.previousSuitePath === 'specs / old'));
+        strict_1.default.deepEqual(addedToSuites, [103]);
+        strict_1.default.deepEqual(removedFromSuites, [102]);
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push moves linked hierarchy-managed cases when the tag-driven suite path changes', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-hierarchy-by-tag-move-'));
+    const filePath = path.join(tempDir, 'specs', 'login.md');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, ['### Existing case', '@tc:55 @suite:new/path', '', 'Steps:', '1. Existing step', ''].join('\n'));
+    fs.writeFileSync(path.join(tempDir, '.ado-sync-state.json'), JSON.stringify({
+        55: {
+            title: 'Existing case',
+            stepsHash: 'cached-steps',
+            descriptionHash: 'cached-description',
+            remoteDescriptionHash: 'cached-remote-description',
+            changedDate: '2026-05-01T00:00:00Z',
+            filePath,
+            suitePathKey: 'old/path',
+        },
+    }, null, 2));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byTag', tagPrefix: 'suite' },
+        },
+    });
+    const addedToSuites = [];
+    const removedFromSuites = [];
+    const suites = [
+        { id: 101, name: 'old', parentSuite: { id: 10 } },
+        { id: 102, name: 'path', parentSuite: { id: 101 } },
+    ];
+    let nextSuiteId = 103;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [],
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+            getTestSuitesForPlan: async () => suites,
+            createTestSuite: async (suite) => {
+                const created = { id: nextSuiteId++, name: suite.name, parentSuite: { id: suite.parentSuite.id } };
+                suites.push(created);
+                return created;
+            },
+            addTestCasesToSuite: async (_entries, _project, _planId, suiteId) => {
+                addedToSuites.push(suiteId);
+            },
+            removeTestCasesFromSuite: async (_project, _planId, suiteId) => {
+                removedFromSuites.push(suiteId);
+            },
+        }),
+        getWitApi: async () => ({
+            getWorkItem: async (id) => ({
+                id,
+                fields: {
+                    'System.Title': 'Existing case',
+                    'System.Description': '',
+                    'Microsoft.VSTS.TCM.Steps': '<steps id="0" last="2"><step id="2" type="ValidateStep"><parameterizedString isformatted="true">&lt;DIV&gt;&lt;P&gt;Step Existing step&lt;/P&gt;&lt;/DIV&gt;</parameterizedString><parameterizedString isformatted="true"></parameterizedString><description/></step></steps>',
+                    'System.Tags': '',
+                    'System.ChangedDate': '2026-05-01T00:00:00Z',
+                },
+            }),
+            updateWorkItem: async () => ({}),
+        }),
+    });
+    try {
+        const results = await (0, engine_1.push)(config, tempDir, { dryRun: false });
+        strict_1.default.ok(results.some((result) => result.action === 'updated' && result.azureId === 55 && result.changedFields?.includes('suite') && result.targetSuitePath === 'new / path' && result.previousSuitePath === 'old / path'));
+        strict_1.default.deepEqual(addedToSuites, [104]);
+        strict_1.default.deepEqual(removedFromSuites, [102]);
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('status previews generated suite targets for hierarchy-managed creates', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-status-hierarchy-target-'));
+    const filePath = path.join(tempDir, 'specs', 'auth', 'login.md');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, ['### Login case', '', 'Steps:', '1. Open app', ''].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byFolder', rootSuite: 'Generated Specs' },
+        },
+    });
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [],
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.status)(config, tempDir);
+        strict_1.default.ok(results.some((result) => result.action === 'created' && result.targetSuitePath === 'Generated Specs / specs / auth'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('status previews tag-driven hierarchy targets for creates', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-status-hierarchy-by-tag-target-'));
+    const filePath = path.join(tempDir, 'specs', 'auth', 'login.md');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, ['### Login case', '<!-- tags: @suite:mobile/auth -->', '', 'Steps:', '1. Open app', ''].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byTag', tagPrefix: 'suite', rootSuite: 'Generated Specs' },
+        },
+    });
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [],
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.status)(config, tempDir);
+        strict_1.default.ok(results.some((result) => result.action === 'created' && result.targetSuitePath === 'Generated Specs / mobile / auth'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('status previews level-rule hierarchy targets for creates', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-status-hierarchy-by-levels-target-'));
+    const filePath = path.join(tempDir, 'specs', 'auth', 'login.md');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, ['### Login case', '<!-- tags: @suite:mobile -->', '', 'Steps:', '1. Open app', ''].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: {
+                mode: 'byLevels',
+                rootSuite: 'Generated Specs',
+                levels: [
+                    { source: 'folder', index: 1 },
+                    { source: 'tag', tagPrefix: 'suite' },
+                ],
+            },
+        },
+    });
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [],
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.status)(config, tempDir);
+        strict_1.default.ok(results.some((result) => result.action === 'created' && result.targetSuitePath === 'Generated Specs / auth / mobile'));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push can prune empty generated suites after a hierarchy-managed move', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-hierarchy-prune-'));
+    const oldRelativePath = 'specs/old/login.md';
+    const newRelativePath = 'specs/new/login.md';
+    const filePath = path.join(tempDir, newRelativePath);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, ['### Existing case', '@tc:55', '', 'Steps:', '1. Existing step', ''].join('\n'));
+    fs.writeFileSync(path.join(tempDir, '.ado-sync-state.json'), JSON.stringify({
+        55: {
+            title: 'Existing case',
+            stepsHash: 'cached-steps',
+            descriptionHash: 'cached-description',
+            remoteDescriptionHash: 'cached-remote-description',
+            changedDate: '2026-05-01T00:00:00Z',
+            filePath: path.join(tempDir, oldRelativePath),
+        },
+    }, null, 2));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byFolder', cleanupEmptySuites: true },
+        },
+    });
+    const deletedSuites = [];
+    const suites = [
+        { id: 101, name: 'specs', parentSuite: { id: 10 } },
+        { id: 102, name: 'old', parentSuite: { id: 101 } },
+    ];
+    let nextSuiteId = 103;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async (_project, _planId, suiteId) => {
+                if (suiteId === 10)
+                    return [{ testCase: { id: 77 } }];
+                if (suiteId === 102 || suiteId === 101)
+                    return [];
+                return [];
+            },
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+            getTestSuitesForPlan: async () => suites,
+            createTestSuite: async (suite) => {
+                const created = { id: nextSuiteId++, name: suite.name, parentSuite: { id: suite.parentSuite.id } };
+                suites.push(created);
+                return created;
+            },
+            addTestCasesToSuite: async () => undefined,
+            removeTestCasesFromSuite: async () => undefined,
+            deleteTestSuite: async (_project, _planId, suiteId) => {
+                deletedSuites.push(suiteId);
+                const index = suites.findIndex((suite) => suite.id === suiteId);
+                if (index >= 0)
+                    suites.splice(index, 1);
+            },
+        }),
+        getWitApi: async () => ({
+            getWorkItem: async (id) => ({
+                id,
+                fields: {
+                    'System.Title': 'Existing case',
+                    'System.Description': '',
+                    'Microsoft.VSTS.TCM.Steps': '<steps id="0" last="2"><step id="2" type="ValidateStep"><parameterizedString isformatted="true">&lt;DIV&gt;&lt;P&gt;Step Existing step&lt;/P&gt;&lt;/DIV&gt;</parameterizedString><parameterizedString isformatted="true"></parameterizedString><description/></step></steps>',
+                    'System.Tags': '',
+                    'System.ChangedDate': '2026-05-01T00:00:00Z',
+                },
+            }),
+            updateWorkItem: async () => ({})
+        }),
+    });
+    try {
+        await (0, engine_1.push)(config, tempDir, { dryRun: false });
+        strict_1.default.deepEqual(deletedSuites, [102]);
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('push can prune empty stale generated suites for removed local specs on full-scope runs', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-push-hierarchy-stale-prune-'));
+    const filePath = path.join(tempDir, 'specs', 'active', 'login.md');
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, ['### Active case', '@tc:55', '', 'Steps:', '1. Existing step', ''].join('\n'));
+    fs.writeFileSync(path.join(tempDir, '.ado-sync-state.json'), JSON.stringify({
+        55: {
+            title: 'Active case',
+            stepsHash: 'cached-steps',
+            descriptionHash: 'cached-description',
+            remoteDescriptionHash: 'cached-remote-description',
+            changedDate: '2026-05-01T00:00:00Z',
+            filePath,
+        },
+        77: {
+            title: 'Removed local case',
+            stepsHash: 'stale-steps',
+            descriptionHash: 'stale-description',
+            remoteDescriptionHash: 'stale-remote-description',
+            changedDate: '2026-05-01T00:00:00Z',
+            filePath: path.join(tempDir, 'specs', 'legacy', 'old.md'),
+            suitePathKey: 'specs/legacy',
+        },
+    }, null, 2));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        testPlan: {
+            id: 1,
+            suiteId: 10,
+            hierarchy: { mode: 'byFolder', cleanupEmptySuites: true },
+        },
+    });
+    const deletedSuites = [];
+    const suites = [
+        { id: 101, name: 'specs', parentSuite: { id: 10 } },
+        { id: 102, name: 'legacy', parentSuite: { id: 101 } },
+        { id: 103, name: 'active', parentSuite: { id: 101 } },
+    ];
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async (_project, _planId, suiteId) => {
+                if (suiteId === 10)
+                    return [{ workItem: { id: 77 } }];
+                if (suiteId === 103)
+                    return [{ workItem: { id: 55 } }];
+                if (suiteId === 102 || suiteId === 101)
+                    return [];
+                return [];
+            },
+            getTestPlanById: async () => ({ id: 1, rootSuite: { id: 10 } }),
+            getTestSuitesForPlan: async () => suites,
+            addTestCasesToSuite: async () => undefined,
+            removeTestCasesFromSuite: async () => undefined,
+            deleteTestSuite: async (_project, _planId, suiteId) => {
+                deletedSuites.push(suiteId);
+                const index = suites.findIndex((suite) => suite.id === suiteId);
+                if (index >= 0)
+                    suites.splice(index, 1);
+            },
+        }),
+        getWitApi: async () => ({
+            getWorkItem: async (id) => ({
+                id,
+                fields: {
+                    'System.Title': id === 55 ? 'Active case' : 'Removed local case',
+                    'System.Description': '',
+                    'Microsoft.VSTS.TCM.Steps': '<steps id="0" last="2"><step id="2" type="ValidateStep"><parameterizedString isformatted="true">&lt;DIV&gt;&lt;P&gt;Step Existing step&lt;/P&gt;&lt;/DIV&gt;</parameterizedString><parameterizedString isformatted="true"></parameterizedString><description/></step></steps>',
+                    'System.Tags': '',
+                    'System.ChangedDate': '2026-05-01T00:00:00Z',
+                },
+            }),
+            getWorkItems: async () => [{
+                    id: 77,
+                    fields: {
+                        'System.WorkItemType': 'Test Case',
+                        'System.Title': 'Removed local case',
+                        'System.Description': '',
+                        'Microsoft.VSTS.TCM.Steps': '<steps id="0" last="2"><step id="2" type="ValidateStep"><parameterizedString isformatted="true">&lt;DIV&gt;&lt;P&gt;Step Existing step&lt;/P&gt;&lt;/DIV&gt;</parameterizedString><parameterizedString isformatted="true"></parameterizedString><description/></step></steps>',
+                        'System.Tags': '',
+                        'System.ChangedDate': '2026-05-01T00:00:00Z',
+                    },
+                }],
+            updateWorkItem: async () => ({}),
+        }),
+    });
+    try {
+        await (0, engine_1.push)(config, tempDir, { dryRun: false });
+        strict_1.default.deepEqual(deletedSuites, [102]);
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
 (0, node_test_1.default)('pull-create errors for unsupported local types instead of creating markdown files', async () => {
     const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-pull-create-'));
     const filePath = path.join(tempDir, 'sample.test.ts');
@@ -392,11 +1375,40 @@ function makeParsedTest(overrides = {}) {
         fs.rmSync(tempDir, { recursive: true, force: true });
     }
 });
+(0, node_test_1.default)('pull-create is blocked on source-file-filtered runs', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-pull-source-file-'));
+    const filePath = path.join(tempDir, 'sample.feature');
+    fs.writeFileSync(filePath, ['Feature: Sample', '', '  Scenario: existing test', '    Given a step', ''].join('\n'));
+    const config = makeConfig({
+        local: { type: 'gherkin', include: '*.feature' },
+        sync: {
+            tagPrefix: 'tc',
+            pull: { enableCreatingNewLocalTestCases: true },
+        },
+    });
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestApi: async () => ({}),
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [],
+            getTestPlanById: async () => ({ rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({ getWorkItems: async () => [] }),
+    });
+    try {
+        const results = await (0, engine_1.pull)(config, tempDir, { sourceFiles: [filePath] });
+        strict_1.default.ok(results.some((result) => result.action === 'error' && /--source-file/.test(result.detail ?? '')));
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
 (0, node_test_1.default)('configurationKey marker prefixes parse namespaced and legacy JavaScript IDs', () => {
     const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-config-key-'));
     const filePath = path.join(tempDir, 'sample.test.ts');
     const config = makeConfig({ configurationKey: 'Smoke Suite' });
-    const markerPrefix = (0, id_markers_1.getPreferredMarkerTagPrefix)(config);
+    const markerPrefix = (0, id_markers_2.getPreferredMarkerTagPrefix)(config);
     try {
         fs.writeFileSync(filePath, [`// @${markerPrefix}:123`, "test('namespaced id', () => {});", ''].join('\n'));
         const namespaced = (0, javascript_1.parseJavaScriptFile)(filePath, [markerPrefix, 'tc']);
@@ -409,4 +1421,124 @@ function makeParsedTest(overrides = {}) {
         fs.rmSync(tempDir, { recursive: true, force: true });
     }
 });
+(0, node_test_1.default)('getTestCasesInSuite filters remote inventory to tagged ownership scope', async () => {
+    const config = makeConfig({
+        configurationKey: 'Smoke Suite',
+        syncTarget: { mode: 'tagged' },
+    });
+    const ownershipTag = (0, id_markers_1.getSyncTargetOwnershipTag)(config);
+    const client = {
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => [
+                { workItem: { id: 101 } },
+                { workItem: { id: 102 } },
+            ],
+            getTestPlanById: async () => ({ rootSuite: { id: 10 } }),
+        }),
+        getWitApi: async () => ({
+            getWorkItems: async () => [
+                { id: 101, fields: { 'System.Title': 'Owned case', 'System.Tags': ownershipTag } },
+                { id: 102, fields: { 'System.Title': 'Other case', 'System.Tags': 'other-owner' } },
+            ],
+        }),
+    };
+    const testCases = await (0, test_cases_1.getTestCasesInSuite)(client, config);
+    strict_1.default.deepEqual(testCases.map((testCase) => testCase.id), [101]);
+});
+(0, node_test_1.default)('getTestCasesInSuite resolves query-based sync targets via WIQL', async () => {
+    const config = makeConfig({
+        syncTarget: {
+            mode: 'query',
+            wiql: "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project AND [System.WorkItemType] = 'Test Case'",
+        },
+    });
+    let suiteFetchCount = 0;
+    const client = {
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => {
+                suiteFetchCount++;
+                return [];
+            },
+        }),
+        getWitApi: async () => ({
+            queryByWiql: async () => ({ workItems: [{ id: 77 }] }),
+            getWorkItems: async () => [{
+                    id: 77,
+                    fields: {
+                        'System.WorkItemType': 'Test Case',
+                        'System.Title': 'Query-owned case',
+                        'System.Tags': '',
+                    },
+                }],
+        }),
+    };
+    const testCases = await (0, test_cases_1.getTestCasesInSuite)(client, config);
+    strict_1.default.equal(suiteFetchCount, 0);
+    strict_1.default.deepEqual(testCases.map((testCase) => testCase.id), [77]);
+});
+(0, node_test_1.default)('status supports query-based sync targets with testPlans', async () => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ado-sync-status-query-testplans-'));
+    const smokePath = path.join(tempDir, 'specs', 'smoke', 'login.md');
+    const regressionPath = path.join(tempDir, 'specs', 'regression', 'checkout.md');
+    fs.mkdirSync(path.dirname(smokePath), { recursive: true });
+    fs.mkdirSync(path.dirname(regressionPath), { recursive: true });
+    fs.writeFileSync(smokePath, ['### Login case', '', 'Steps:', '1. Open app', ''].join('\n'));
+    fs.writeFileSync(regressionPath, ['### Checkout case', '', 'Steps:', '1. Add item', ''].join('\n'));
+    const config = makeConfig({
+        local: { type: 'markdown', include: 'specs/**/*.md' },
+        syncTarget: {
+            mode: 'query',
+            wiql: "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project AND [System.WorkItemType] = 'Test Case'",
+        },
+        testPlans: [
+            { id: 11, include: 'specs/smoke/**/*.md' },
+            { id: 22, include: 'specs/regression/**/*.md' },
+        ],
+    });
+    let suiteFetchCount = 0;
+    let queryCount = 0;
+    const originalCreate = client_1.AzureClient.create;
+    client_1.AzureClient.create = async () => ({
+        getTestPlanApi: async () => ({
+            getTestCaseList: async () => {
+                suiteFetchCount++;
+                return [];
+            },
+            getTestPlanById: async (_project, planId) => ({ id: planId, rootSuite: { id: planId * 10 } }),
+        }),
+        getWitApi: async () => ({
+            queryByWiql: async () => {
+                queryCount++;
+                return { workItems: [] };
+            },
+            getWorkItems: async () => [],
+        }),
+    });
+    try {
+        const results = await (0, engine_1.status)(config, tempDir);
+        strict_1.default.equal(queryCount, 2);
+        strict_1.default.equal(suiteFetchCount, 0);
+        strict_1.default.equal(results.filter((result) => result.action === 'created').length, 2);
+    }
+    finally {
+        client_1.AzureClient.create = originalCreate;
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('detectAiEnvironment returns heuristic when Visual Studio Agent mode env is set', () => {
+    withCleanAiDetectionEnv({
+        VISUAL_STUDIO_AGENT_MODE: '1',
+    }, () => {
+        const detected = (0, summarizer_1.detectAiEnvironment)();
+        strict_1.default.equal(detected?.provider, 'heuristic');
+    });
+});
+(0, node_test_1.default)('detectAiEnvironment returns heuristic when Codex env signal is set', () => {
+    withCleanAiDetectionEnv({
+        CODEX_CLI: '1',
+    }, () => {
+        const detected = (0, summarizer_1.detectAiEnvironment)();
+        strict_1.default.equal(detected?.provider, 'heuristic');
+    });
+});
 //# sourceMappingURL=regressions.test.js.map