ado-sync 0.1.47 → 0.1.49

package/dist/cli.js

@@ -37,15 +37,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-// Suppress the url.parse() deprecation warning emitted by azure-devops-node-api internals.
-// This is DEP0169 and cannot be fixed on our side.
-const originalEmit = process.emit;
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-process.emit = function (event, ...args) {
-    if (event === 'warning' && args[0]?.code === 'DEP0169')
-        return false;
-    return originalEmit.apply(process, [event, ...args]);
-};
+// Suppress the url.parse() deprecation warning (DEP0169) emitted by azure-devops-node-api
+// internals. Cannot be fixed on our side; use the warning event listener instead of
+// monkey-patching process.emit.
+process.on('warning', (warning) => {
+    if (warning.code === 'DEP0169')
+        return;
+    process.stderr.write(`[node:warning] ${warning.name}: ${warning.message}\n`);
+});
 require("dotenv/config");
 const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
@@ -58,6 +57,7 @@ const client_1 = require("./azure/client");
 const config_1 = require("./config");
 const engine_1 = require("./sync/engine");
 const generate_1 = require("./sync/generate");
+const manifest_1 = require("./sync/manifest");
 const publish_results_1 = require("./sync/publish-results");
 // ─── CLI definition ───────────────────────────────────────────────────────────
 const program = new commander_1.Command();
@@ -69,24 +69,31 @@ program
 program.option('-c, --config <path>', 'Path to config file (default: ado-sync.json)');
 program.option('--output <format>', 'Output format: text (default) or json');
 // ─── Error formatting (L) ─────────────────────────────────────────────────────
+function toError(err) {
+    if (err instanceof Error)
+        return err;
+    return { message: String(err) };
+}
 function formatError(err) {
-    const status = err?.statusCode ?? err?.status ?? 0;
+    const e = toError(err);
+    const status = e.statusCode ?? e.status ?? 0;
     if (status === 401)
         return 'Authentication failed. Check your token (auth.token) and permissions.';
     if (status === 403)
         return 'Access denied. Your token lacks the required Azure DevOps scopes.';
     if (status === 404)
-        return `Resource not found. Check your orgUrl, project, or test plan ID.\n  ${err.message}`;
+        return `Resource not found. Check your orgUrl, project, or test plan ID.\n  ${e.message}`;
     if (status === 429)
         return 'Azure DevOps rate limit hit. Reduce concurrent operations or retry later.';
     if (status === 503)
         return 'Azure DevOps is temporarily unavailable (503). Retry later.';
-    return err?.message ?? String(err);
+    return e.message;
 }
 function handleError(err) {
-    console.error(chalk_1.default.red(formatError(err)));
+    const e = toError(err);
+    console.error(chalk_1.default.red(formatError(e)));
     if (process.env.DEBUG)
-        console.error(chalk_1.default.dim(err?.stack ?? ''));
+        console.error(chalk_1.default.dim(e.stack ?? ''));
     process.exit(1);
 }
 /** Collect repeatable option values into an array. */
@@ -140,7 +147,8 @@ function buildAiOpts(opts, config, configDir) {
             contextContent = fs.readFileSync(absContextPath, 'utf8');
         }
         catch (err) {
-            process.stderr.write(`  [ai-summary] Warning: could not read contextFile "${absContextPath}": ${err.message}\n`);
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`  [ai-summary] Warning: could not read contextFile "${absContextPath}": ${msg}\n`);
         }
     }
     return {
@@ -337,13 +345,19 @@ program
 // ─── publish-test-results ─────────────────────────────────────────────────────
 program
     .command('publish-test-results')
-    .description('Publish test results from result files (TRX, JUnit, Cucumber JSON) to Azure DevOps')
+    .description('Publish test results from result files (TRX, JUnit, Cucumber JSON, CTRF) to Azure DevOps')
     .option('--testResult <path>', 'Path to a test result file (repeatable)', collect, [])
-    .option('--testResultFormat <format>', 'Result file format: trx, nunitXml, junit, cucumberJson, playwrightJson')
+    .option('--testResultFormat <format>', 'Result file format: trx, nunitXml, junit, cucumberJson, playwrightJson, ctrfJson')
     .option('--attachmentsFolder <path>', 'Folder with screenshots/videos/logs to attach to test results')
     .option('--runName <name>', 'Name for the test run in Azure DevOps')
     .option('--buildId <id>', 'Build ID to associate with the test run')
     .option('--dry-run', 'Parse results and show summary without publishing')
+    .option('--create-issues-on-failure', 'File GitHub Issues or ADO Bugs for each failed test')
+    .option('--issue-provider <provider>', 'Issue provider: github (default) or ado')
+    .option('--github-repo <owner/repo>', 'GitHub repository to file issues in (e.g. "myorg/myrepo")')
+    .option('--github-token <token>', 'GitHub token ($ENV_VAR reference supported)')
+    .option('--bug-threshold <percent>', 'Failure % above which one env-failure issue is filed instead of per-test (default: 20)')
+    .option('--max-issues <n>', 'Hard cap on issues filed per run (default: 50)')
     .option('--config-override <path=value>', 'Override a config value (repeatable)', collect, [])
     .action(async (opts) => {
     const globalOpts = program.opts();
@@ -365,6 +379,14 @@ program
             attachmentsFolder: opts.attachmentsFolder,
             runName: opts.runName,
             buildId: opts.buildId ? parseInt(opts.buildId) : undefined,
+            createIssuesOnFailure: opts.createIssuesOnFailure,
+            issueOverrides: {
+                ...(opts.issueProvider && { provider: opts.issueProvider }),
+                ...(opts.githubRepo && { repo: opts.githubRepo }),
+                ...(opts.githubToken && { token: opts.githubToken }),
+                ...(opts.bugThreshold && { threshold: parseInt(opts.bugThreshold) }),
+                ...(opts.maxIssues && { maxIssues: parseInt(opts.maxIssues) }),
+            },
         });
         console.log(chalk_1.default.green(`Total results: ${result.totalResults}`));
         console.log(`  ${chalk_1.default.green(`${result.passed} passed`)}  ${chalk_1.default.red(`${result.failed} failed`)}  ${chalk_1.default.dim(`${result.other} other`)}`);
@@ -372,6 +394,21 @@ program
             console.log(chalk_1.default.dim(`Run ID: ${result.runId}`));
             console.log(chalk_1.default.dim(`URL: ${result.runUrl}`));
         }
+        if (result.issuesSummary) {
+            const s = result.issuesSummary;
+            console.log('');
+            console.log(chalk_1.default.bold('Issues filed:'));
+            console.log(chalk_1.default.dim(`  Mode: ${s.mode}  |  Total failed: ${s.totalFailed}  |  Suppressed: ${s.suppressed}`));
+            for (const issue of s.issued) {
+                const prefix = issue.action === 'created' ? chalk_1.default.green('+')
+                    : issue.action === 'skipped' ? chalk_1.default.dim('=')
+                        : chalk_1.default.yellow('~');
+                const detail = issue.url ? chalk_1.default.dim(` → ${issue.url}`)
+                    : issue.reason ? chalk_1.default.dim(` (${issue.reason})`)
+                        : '';
+                console.log(`  ${prefix} ${issue.title}${detail}`);
+            }
+        }
     }
     catch (err) {
         handleError(err);
@@ -509,7 +546,8 @@ program
         console.log(chalk_1.default.green('  ✓ Config is valid'));
     }
     catch (err) {
-        console.log(chalk_1.default.red(`  ✗ Config error: ${err.message}`));
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(chalk_1.default.red(`  ✗ Config error: ${msg}`));
         process.exit(1);
     }
     // 2. Connect to Azure
@@ -559,6 +597,8 @@ program
     .description('Show field-level diff between local specs and Azure DevOps')
     .option('--tags <expression>', 'Only check scenarios matching this tag expression')
     .option('--config-override <path=value>', 'Override a config value (repeatable)', collect, [])
+    .option('--format <fmt>', 'Output format: text (default) or json')
+    .option('--fail-on-drift', 'Exit with code 1 when any differences are found (useful as a CI quality gate)')
     .option('--ai-provider <provider>', 'AI provider for test step generation')
     .option('--ai-model <model>', 'AI model path or name')
     .option('--ai-url <url>', 'Base URL for AI endpoint')
@@ -578,9 +618,22 @@ program
         console.log('');
         const aiSummary = buildAiOpts(opts, config, configDir);
         const results = await (0, engine_1.status)(config, configDir, { tags: opts.tags, aiSummary });
-        const outputFormat = program.opts().output;
+        // --format json or global --output json
+        const outputFormat = opts.format ?? program.opts().output;
         if (outputFormat === 'json') {
-            process.stdout.write(JSON.stringify(results, null, 2) + '\n');
+            const diffs = results
+                .filter((r) => r.action === 'updated' || r.action === 'conflict')
+                .map((r) => ({
+                action: r.action,
+                azureId: r.azureId,
+                title: r.title,
+                filePath: r.filePath ? path.relative(process.cwd(), r.filePath) : '',
+                changedFields: r.changedFields ?? [],
+                diffDetail: r.diffDetail ?? [],
+            }));
+            process.stdout.write(JSON.stringify({ total: results.length, diffs }, null, 2) + '\n');
+            if (opts.failOnDrift && diffs.length > 0)
+                process.exit(1);
             return;
         }
         let anyDiff = false;
@@ -595,12 +648,23 @@ program
             if (r.changedFields?.length) {
                 console.log(chalk_1.default.dim(`    changed fields: ${r.changedFields.join(', ')}`));
             }
+            if (r.diffDetail?.length) {
+                for (const d of r.diffDetail) {
+                    const local = String(d.local).slice(0, 80).replace(/\n/g, '↵');
+                    const remote = String(d.remote).slice(0, 80).replace(/\n/g, '↵');
+                    console.log(chalk_1.default.dim(`    ${d.field}:`));
+                    console.log(chalk_1.default.green(`      local:  ${local}`));
+                    console.log(chalk_1.default.red(`      remote: ${remote}`));
+                }
+            }
             else if (r.detail) {
                 console.log(chalk_1.default.dim(`    ${r.detail}`));
             }
         }
         if (!anyDiff)
             console.log(chalk_1.default.dim('No differences found.'));
+        if (opts.failOnDrift && anyDiff)
+            process.exit(1);
     }
     catch (err) {
         handleError(err);
@@ -609,12 +673,13 @@ program
 // ─── generate ────────────────────────────────────────────────────────────────
 program
     .command('generate')
-    .description('Generate local spec files from Azure DevOps User Stories')
+    .description('Generate local spec files (or AI workflow manifests) from Azure DevOps User Stories')
     .option('--story-ids <ids>', 'Comma-separated ADO work item IDs (e.g. 1234,5678)')
     .option('--query <wiql>', 'WIQL query string to select stories')
     .option('--area-path <path>', 'Filter by area path')
     .option('--format <fmt>', 'Output format: gherkin or markdown (default: markdown)')
     .option('--output-folder <dir>', 'Where to write files (default: config pull.targetFolder or .)')
+    .option('--manifest', 'Generate .ai-workflow-manifest-{id}.json instead of spec files')
     .option('--force', 'Overwrite existing files')
     .option('--dry-run', 'Show what would be created without writing files')
     .option('--config-override <path=value>', 'Override a config value (repeatable)', collect, [])
@@ -626,15 +691,55 @@ program
         if (opts.configOverride?.length)
             (0, config_1.applyOverrides)(config, opts.configOverride);
         const configDir = path.dirname(configPath);
+        const outputFormat = globalOpts.output;
+        const storyIds = opts.storyIds
+            ? opts.storyIds.split(',').map((s) => parseInt(s.trim(), 10)).filter(Boolean)
+            : undefined;
+        if (opts.manifest) {
+            // ── Manifest mode ──────────────────────────────────────────────────────
+            if (!storyIds?.length) {
+                console.error(chalk_1.default.red('--story-ids is required with --manifest'));
+                process.exit(1);
+            }
+            console.log(chalk_1.default.bold('ado-sync generate --manifest'));
+            console.log(chalk_1.default.dim(`Config: ${configPath}`));
+            if (opts.dryRun)
+                console.log(chalk_1.default.yellow('Dry run — no files will be written'));
+            console.log('');
+            const results = await (0, manifest_1.generateManifests)(config, configDir, {
+                storyIds,
+                outputFolder: opts.outputFolder,
+                format: opts.format,
+                force: opts.force ?? false,
+                dryRun: opts.dryRun ?? false,
+            });
+            if (outputFormat === 'json') {
+                process.stdout.write(JSON.stringify(results, null, 2) + '\n');
+                return;
+            }
+            for (const r of results) {
+                const symbol = r.action === 'created' ? chalk_1.default.green('+') : chalk_1.default.dim('=');
+                const relPath = path.relative(process.cwd(), r.filePath);
+                console.log(`${symbol} [#${r.storyId}] ${relPath} — ${r.title}`);
+                if (r.manifest && r.action === 'created') {
+                    console.log(chalk_1.default.dim(`    ${r.manifest.context.acceptanceCriteria.length} AC items · ${r.manifest.context.suggestedTags.join(' ')} · ${r.manifest.context.relatedTestCases.length} linked TCs`));
+                }
+            }
+            console.log('');
+            const created = results.filter((r) => r.action === 'created').length;
+            const skipped = results.filter((r) => r.action === 'skipped').length;
+            console.log([
+                created && chalk_1.default.green(`${created} manifest${created !== 1 ? 's' : ''} created`),
+                skipped && chalk_1.default.dim(`${skipped} skipped`),
+            ].filter(Boolean).join(chalk_1.default.dim('  ')) || chalk_1.default.dim('Nothing to generate.'));
+            return;
+        }
+        // ── Spec file mode ─────────────────────────────────────────────────────
         console.log(chalk_1.default.bold('ado-sync generate'));
         console.log(chalk_1.default.dim(`Config: ${configPath}`));
         if (opts.dryRun)
             console.log(chalk_1.default.yellow('Dry run — no files will be written'));
         console.log('');
-        const storyIds = opts.storyIds
-            ? opts.storyIds.split(',').map((s) => parseInt(s.trim(), 10)).filter(Boolean)
-            : undefined;
-        const outputFormat = program.opts().output;
         const results = await (0, generate_1.generateSpecs)(config, configDir, {
             storyIds,
             query: opts.query,
@@ -665,6 +770,238 @@ program
         handleError(err);
     }
 });
+// ─── story-context ────────────────────────────────────────────────────────────
+program
+    .command('story-context')
+    .description('Show planner-agent context for an ADO User Story (AC items, suggested tags, linked TCs)')
+    .requiredOption('--story-id <id>', 'ADO work item ID')
+    .option('--config-override <path=value>', 'Override a config value (repeatable)', collect, [])
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    try {
+        const configPath = (0, config_1.resolveConfigPath)(globalOpts.config);
+        const config = (0, config_1.loadConfig)(configPath);
+        if (opts.configOverride?.length)
+            (0, config_1.applyOverrides)(config, opts.configOverride);
+        const { AzureClient } = await Promise.resolve().then(() => __importStar(require('./azure/client')));
+        const { getStoryContext } = await Promise.resolve().then(() => __importStar(require('./azure/work-items')));
+        const client = await AzureClient.create(config);
+        const ctx = await getStoryContext(client, config.project, parseInt(opts.storyId, 10), config.orgUrl);
+        if (globalOpts.output === 'json') {
+            process.stdout.write(JSON.stringify(ctx, null, 2) + '\n');
+            return;
+        }
+        console.log(chalk_1.default.bold(`Story #${ctx.storyId}: ${ctx.title}`));
+        console.log(chalk_1.default.dim(`State: ${ctx.state ?? 'unknown'}  |  ${ctx.url}`));
+        console.log('');
+        if (ctx.acItems.length) {
+            console.log(chalk_1.default.bold('Acceptance Criteria:'));
+            ctx.acItems.forEach((item, i) => console.log(`  ${chalk_1.default.dim(`${i + 1}.`)} ${item}`));
+            console.log('');
+        }
+        if (ctx.suggestedTags.length) {
+            console.log(`${chalk_1.default.bold('Suggested tags:')}  ${ctx.suggestedTags.join('  ')}`);
+        }
+        if (ctx.suggestedActors.length) {
+            console.log(`${chalk_1.default.bold('Actors:')}          ${ctx.suggestedActors.join(', ')}`);
+        }
+        if (ctx.relatedTestCases.length) {
+            console.log(`${chalk_1.default.bold('Linked TCs:')}      ${ctx.relatedTestCases.map((id) => `#${id}`).join(', ')}`);
+        }
+        else {
+            console.log(chalk_1.default.dim('No linked test cases yet.'));
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+// ─── stale ───────────────────────────────────────────────────────────────────
+program
+    .command('stale')
+    .description('List Azure DevOps Test Cases that have no corresponding local spec')
+    .option('--tags <expression>', 'Only consider local specs matching this tag expression')
+    .option('--config-override <path=value>', 'Override a config value (repeatable)', collect, [])
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    try {
+        const configPath = (0, config_1.resolveConfigPath)(globalOpts.config);
+        const config = (0, config_1.loadConfig)(configPath);
+        if (opts.configOverride?.length)
+            (0, config_1.applyOverrides)(config, opts.configOverride);
+        const configDir = path.dirname(configPath);
+        console.log(chalk_1.default.bold('ado-sync stale'));
+        console.log(chalk_1.default.dim(`Config: ${configPath}`));
+        if (opts.tags)
+            console.log(chalk_1.default.dim(`Tags:   ${opts.tags}`));
+        console.log('');
+        const staleCases = await (0, engine_1.detectStaleTestCases)(config, configDir, { tags: opts.tags });
+        const outputFormat = globalOpts.output;
+        if (outputFormat === 'json') {
+            process.stdout.write(JSON.stringify(staleCases, null, 2) + '\n');
+            return;
+        }
+        if (staleCases.length === 0) {
+            console.log(chalk_1.default.green('No stale test cases found.'));
+            return;
+        }
+        for (const tc of staleCases) {
+            const tagsStr = tc.tags.length ? chalk_1.default.dim(`  [${tc.tags.join(', ')}]`) : '';
+            console.log(`${chalk_1.default.yellow('?')} ${chalk_1.default.dim(`[#${tc.id}]`)} ${tc.title}${tagsStr}`);
+        }
+        console.log('');
+        console.log(chalk_1.default.yellow(`${staleCases.length} stale test case${staleCases.length !== 1 ? 's' : ''} — not referenced by any local spec.`));
+        console.log(chalk_1.default.dim('Run `ado-sync push` to tag them as ado-sync:removed, or delete them manually.'));
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+// ─── coverage ────────────────────────────────────────────────────────────────
+program
+    .command('coverage')
+    .description('Show spec link rate and story coverage for local specs vs Azure DevOps')
+    .option('--tags <expression>', 'Only consider local specs matching this tag expression')
+    .option('--config-override <path=value>', 'Override a config value (repeatable)', collect, [])
+    .option('--fail-below <percent>', 'Exit with code 1 when spec link rate is below this threshold (0–100)')
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    try {
+        const configPath = (0, config_1.resolveConfigPath)(globalOpts.config);
+        const config = (0, config_1.loadConfig)(configPath);
+        if (opts.configOverride?.length)
+            (0, config_1.applyOverrides)(config, opts.configOverride);
+        const configDir = path.dirname(configPath);
+        console.log(chalk_1.default.bold('ado-sync coverage'));
+        console.log(chalk_1.default.dim(`Config: ${configPath}`));
+        if (opts.tags)
+            console.log(chalk_1.default.dim(`Tags:   ${opts.tags}`));
+        console.log('');
+        const report = await (0, engine_1.coverageReport)(config, configDir, { tags: opts.tags });
+        const outputFormat = globalOpts.output;
+        if (outputFormat === 'json') {
+            process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+        }
+        else {
+            const linkColor = report.specLinkRate >= 80 ? chalk_1.default.green : report.specLinkRate >= 50 ? chalk_1.default.yellow : chalk_1.default.red;
+            console.log(chalk_1.default.bold('Spec link rate'));
+            console.log(`  ${linkColor(`${report.specLinkRate}%`)}  ${chalk_1.default.dim(`(${report.linkedSpecs} of ${report.totalLocalSpecs} specs linked to Azure Test Cases)`)}`);
+            if (report.unlinkedSpecs > 0) {
+                console.log(`  ${chalk_1.default.dim(`${report.unlinkedSpecs} unlinked — run \`ado-sync push\` to create Azure Test Cases for them`)}`);
+            }
+            if (report.storiesReferenced.length > 0) {
+                console.log('');
+                const storyColor = report.storyCoverageRate >= 80 ? chalk_1.default.green : report.storyCoverageRate >= 50 ? chalk_1.default.yellow : chalk_1.default.red;
+                console.log(chalk_1.default.bold('Story coverage'));
+                console.log(`  ${storyColor(`${report.storyCoverageRate}%`)}  ${chalk_1.default.dim(`(${report.storiesCovered.length} of ${report.storiesReferenced.length} referenced stories have linked specs)`)}`);
+                if (report.storiesUncovered.length > 0) {
+                    console.log(`  ${chalk_1.default.dim('Uncovered stories: ')}${report.storiesUncovered.map((id) => `#${id}`).join(', ')}`);
+                }
+            }
+            else {
+                console.log('');
+                console.log(chalk_1.default.dim('No @story: tags found — add @story:ID tags to specs to track story coverage.'));
+            }
+        }
+        const threshold = opts.failBelow ? parseInt(opts.failBelow, 10) : undefined;
+        if (threshold !== undefined && report.specLinkRate < threshold) {
+            console.error(chalk_1.default.red(`\nSpec link rate ${report.specLinkRate}% is below threshold ${threshold}%`));
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+// ─── watch ────────────────────────────────────────────────────────────────────
+program
+    .command('watch')
+    .description('Watch local spec files for changes and auto-push on save')
+    .option('--dry-run', 'Show what would change without making any modifications')
+    .option('--tags <expression>', 'Only sync scenarios matching this tag expression')
+    .option('--debounce <ms>', 'Debounce delay in milliseconds before running push (default: 800)', '800')
+    .option('--config-override <path=value>', 'Override a config value (repeatable)', collect, [])
+    .option('--ai-provider <provider>', 'AI provider for test step generation')
+    .option('--ai-model <model>', 'AI model path or name')
+    .option('--ai-url <url>', 'Base URL for AI endpoint')
+    .option('--ai-key <key>', 'API key for AI provider')
+    .action(async (opts) => {
+    const globalOpts = program.opts();
+    try {
+        const configPath = (0, config_1.resolveConfigPath)(globalOpts.config);
+        const config = (0, config_1.loadConfig)(configPath);
+        if (opts.configOverride?.length)
+            (0, config_1.applyOverrides)(config, opts.configOverride);
+        const configDir = path.dirname(configPath);
+        const debounceMs = parseInt(opts.debounce ?? '800', 10);
+        console.log(chalk_1.default.bold('ado-sync watch'));
+        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('');
+        console.log(chalk_1.default.dim(`Watching ${configDir} for changes... (Ctrl+C to stop)`));
+        console.log('');
+        const aiSummary = buildAiOpts(opts, config, configDir);
+        let debounceTimer;
+        let running = false;
+        const runPush = async () => {
+            if (running)
+                return;
+            running = true;
+            const ts = new Date().toLocaleTimeString();
+            console.log(chalk_1.default.dim(`[${ts}] Change detected — running push...`));
+            try {
+                const isTTY = process.stdout.isTTY ?? false;
+                const onProgress = createProgressCallback(isTTY);
+                const results = await (0, engine_1.push)(config, configDir, {
+                    dryRun: opts.dryRun,
+                    tags: opts.tags,
+                    onProgress,
+                    aiSummary,
+                });
+                if (isTTY)
+                    clearProgressLine();
+                printResults(results, config.toolSettings?.outputLevel);
+            }
+            catch (err) {
+                console.error(chalk_1.default.red(`Push failed: ${err instanceof Error ? err.message : String(err)}`));
+            }
+            finally {
+                running = false;
+            }
+        };
+        const onChange = () => {
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(runPush, debounceMs);
+        };
+        // Watch the config directory recursively for changes to spec files
+        const watcher = fs.watch(configDir, { recursive: true }, (eventType, filename) => {
+            if (!filename)
+                return;
+            // Only react to spec file changes, not the cache or config file itself
+            const skipPatterns = ['.ado-sync-cache.json', 'ado-sync.json', 'ado-sync.yml', 'node_modules'];
+            if (skipPatterns.some((p) => filename.includes(p)))
+                return;
+            onChange();
+        });
+        // Keep process alive
+        process.on('SIGINT', () => {
+            watcher.close();
+            console.log('\n' + chalk_1.default.dim('Watch mode stopped.'));
+            process.exit(0);
+        });
+        // Trigger an initial push on start
+        await runPush();
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
 // ─── Run ─────────────────────────────────────────────────────────────────────
 program.parse(process.argv);
 //# sourceMappingURL=cli.js.map