ado-sync 0.1.47 → 0.1.48

package/.next-steps.md

@@ -0,0 +1,179 @@
+What I'd build next (priority order)
+
+1. create_issue_on_failure — GitHub Issues + ADO Bugs (dual provider) ✅ DONE
+
+When publish-test-results finds failures, automatically file issues so agents can pick them up
+and propose fix PRs. Supports both GitHub Issues and ADO Bugs as providers under one config key.
+
+--- Why GitHub Issues is the better default ---
+
+GitHub Issues is preferred over ADO Bugs for most teams because:
+  - 5,000 req/hour API limit vs ADO's stricter rate limits
+  - The healer agent lives in GitHub Actions — Issue → PR → auto-close on merge is native
+  - Only requires repo `issues: write` permission, not ADO Work Items (Write)
+  - Dedup by label search is simpler than WiQL queries
+  - Issue body can embed the ADO TC URL, so full traceability is preserved
+
+ADO Bugs remain available for teams fully inside ADO (no GitHub, or policy requires bugs in ADO).
+
+--- The bulk-failure problem ---
+
+A full environment outage (app down, auth broken) can fail 10,000 tests and would create 10,000
+issues, hitting API limits and flooding the tracker. Guards are applied in order before any issue
+is filed:
+
+  1. Failure rate threshold (default 20%)
+     If >20% of tests fail → skip per-test issues entirely.
+     Create ONE environment-failure issue with a summary of all failures.
+
+  2. Error signature clustering
+     Group failures by hashed error message.
+     If 500 tests all fail with ERR_CONNECTION_REFUSED → ONE cluster issue listing affected tests
+     (up to 20 names, then "+ N more").
+
+  3. Hard cap (default 50)
+     Ceiling regardless of strategy. After the cap, one "overflow" summary issue is created:
+     "50 issues filed; X additional failures suppressed — possible environment issue."
+
+  4. Dedup against open issues
+     Skip creation if an open issue already exists for that TC (matched by label tc:ID or title).
+
+Decision tree at runtime:
+
+  failures > threshold% of total?
+    └─ YES → 1 environment issue, stop
+    └─ NO
+         └─ cluster by error signature
+              └─ cluster size > 10?
+                   └─ YES → 1 issue per cluster (lists affected TCs)
+                   └─ NO  → 1 issue per TC (up to maxIssues cap)
+                                 └─ cap hit? → 1 overflow summary issue
+
+--- CLI ---
+
+  ado-sync publish-test-results \
+    --testResult results/ctrf.json \
+    --create-issues-on-failure \
+    --github-repo owner/repo \
+    --github-token $GITHUB_TOKEN
+
+  # ADO Bugs instead:
+  ado-sync publish-test-results \
+    --testResult results/ctrf.json \
+    --create-issues-on-failure \
+    --issue-provider ado
+
+--- Config (ado-sync.json) ---
+
+  {
+    "publishTestResults": {
+      "createIssuesOnFailure": {
+        "provider": "github",          // "github" | "ado"
+        "repo": "owner/repo",          // GitHub only
+        "labels": ["test-failure", "automated"],
+        "threshold": 20,               // % of failures that triggers env-failure mode
+        "maxIssues": 50,               // hard cap per run
+        "clusterByError": true,        // group same-error failures into one issue
+        "dedupByTestCase": true,       // skip if open issue for TC already exists
+        "areaPath": "MyProject\\QA",   // ADO only
+        "assignTo": "$AZURE_DEVOPS_USER"
+      }
+    }
+  }
+
+--- MCP tools ---
+
+  create_issue({ title, failureDetails, testCaseId, buildId, provider })
+    → files one issue (GitHub or ADO) and returns the issue/bug URL
+
+  create_issues_from_run({ runId, provider, ...guardOptions })
+    → applies full guard logic against a completed test run, returns summary
+
+--- GitHub Issue body template ---
+
+  ## Test failure: {testName}
+
+  | Field        | Value |
+  |---|---|
+  | ADO Test Case | [#{testCaseId}]({adoTcUrl}) |
+  | Build         | #{buildId} |
+  | Run           | [View in Azure DevOps]({runUrl}) |
+  | File          | {filePath}:{line} |
+
+  ### Error
+  ```
+  {errorMessage}
+  ```
+
+  ### Stack trace
+  ```
+  {stackTrace}
+  ```
+
+  /cc @healer-agent
+
+This unblocks Use Case 4 — the GitHub Agentic Workflow where the Playwright Healer Agent reads
+the issue, understands the failure from errorMessage + stackTrace + ADO TC context, then proposes
+a fix PR. The issue is the handoff between CI and the healer.
+
+2. CTRF format support in publish-test-results ✅ DONE
+The scope doc and materia article both use CTRF. It's becoming the standard cross-framework report format. Teams using the materia pattern will arrive with CTRF output expecting ado-sync to accept it.
+Auto-detected from results.tests array structure. TC IDs from tags[] or test name. Attachments,
+stdout/stderr uploaded automatically. Documented in docs/publish-test-results.md.
+
+3. get_story_context MCP tool (Planner agent feed) ✅ DONE
+Returns AC items (bullet list), inferred tags (@smoke, @auth…), extracted actors, and linked TC IDs.
+CLI: ado-sync story-context --story-id 1234
+MCP: get_story_context({ storyId: 1234 })
+Implemented in src/azure/work-items.ts — getStoryContext() with tag inference + actor extraction.
+
+4. ai-workflow-manifest.json generator ✅ DONE
+CLI: ado-sync generate --manifest --story-ids 1234
+MCP: generate_manifest({ storyIds: [1234], outputFolder: "e2e/bdd", format: "gherkin" })
+Writes .ai-workflow-manifest-{id}.json with 8-step workflow, AC items, required docs checklist,
+validation steps, and output paths. Implemented in src/sync/manifest.ts.
+
+5. GitHub Actions reusable workflow
+The scope doc explicitly asks for this:
+
+"There is need to write GitHub Actions templates in TR Org Workflows repo"
+
+A reusable workflow file:
+
+
+# .github/workflows/ado-sync.yml (reusable)
+on:
+  workflow_call:
+    inputs:
+      test-result-path: ...
+      create-issues-on-failure: ...
+Teams subscribe to it — one-line adoption in their own pipelines.
+
+6. Flaky test detection in publish-test-results
+Materia's 4-method flaky detection:
+
+Summary-level flaky count
+Retry pattern analysis
+Explicit marking
+Passed-after-retry
+Add a --detect-flaky flag that outputs a flaky test report alongside the ADO publish. Tag flaky TCs in ADO with ado-sync:flaky so you can track trends across runs.
+
+The full picture
+
+User Story (ADO)
+    ↓  get_story_context (MCP)
+Planner Agent → Markdown spec
+    ↓  generate --manifest
+.ai-workflow-manifest.json + spec file
+    ↓  generate (existing)
+Playwright test skeleton
+    ↓  push (existing)
+ADO Test Case with @tc:ID writeback
+    ↓  CI runs tests
+CTRF / Playwright JSON results
+    ↓  publish-test-results (existing + flaky detection)
+ADO Test Run results
+    ↓  failures → create_issue_on_failure (new, GitHub Issues or ADO Bugs)
+GitHub Issue / ADO Bug → Healer Agent → fix PR
+ado-sync becomes the connective tissue across all 4 use cases in that scope document. Right now you cover the right half. Items 1–3 above close the loop on Use Cases 3 and 4.
+

package/dist/azure/work-items.d.ts

@@ -1,6 +1,10 @@
 /**
  * Fetch Azure DevOps User Stories (or any work item type) with their
  * Acceptance Criteria and Description fields, for use by the `generate` command.
+ *
+ * Also exposes getStoryContext() — a richer, planner-agent-optimised view that
+ * adds related Test Case IDs, bullet-formatted AC items, suggested tags, and
+ * extracted actors (user roles) parsed from the Acceptance Criteria text.
  */
 import { AzureClient } from './client';
 export interface AdoStory {
@@ -26,6 +30,30 @@ export declare function getWorkItemsByIds(client: AzureClient, _project: string,
  *   "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project AND [System.WorkItemType] = 'User Story'"
  */
 export declare function getWorkItemsByQuery(client: AzureClient, project: string, wiql: string): Promise<AdoStory[]>;
+export interface StoryContext {
+    storyId: number;
+    title: string;
+    description?: string;
+    /** Raw AC text — HTML stripped */
+    acceptanceCriteria?: string;
+    /** AC split into individual bullet items, stripped of list markers */
+    acItems: string[];
+    state?: string;
+    adoTags?: string[];
+    /** Inferred test tags from AC/title keywords: @smoke, @regression, @auth, etc. */
+    suggestedTags: string[];
+    /** User roles / actors extracted from AC text (e.g. "admin", "guest user") */
+    suggestedActors: string[];
+    /** ADO Test Case IDs already linked to this story via TestedBy relation */
+    relatedTestCases: number[];
+    /** Direct URL to the work item in Azure DevOps */
+    url: string;
+}
+/**
+ * Return a planner-agent-optimised view of a single User Story.
+ * Includes related TC IDs (already written), suggested tags, and extracted actors.
+ */
+export declare function getStoryContext(client: AzureClient, project: string, storyId: number, orgUrl: string): Promise<StoryContext>;
 /**
  * Fetch User Stories under a specific area path.
  */

package/dist/azure/work-items.js

@@ -2,10 +2,15 @@
 /**
  * Fetch Azure DevOps User Stories (or any work item type) with their
  * Acceptance Criteria and Description fields, for use by the `generate` command.
+ *
+ * Also exposes getStoryContext() — a richer, planner-agent-optimised view that
+ * adds related Test Case IDs, bullet-formatted AC items, suggested tags, and
+ * extracted actors (user roles) parsed from the Acceptance Criteria text.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getWorkItemsByIds = getWorkItemsByIds;
 exports.getWorkItemsByQuery = getWorkItemsByQuery;
+exports.getStoryContext = getStoryContext;
 exports.getWorkItemsByAreaPath = getWorkItemsByAreaPath;
 const FIELDS = [
     'System.Id',
@@ -84,6 +89,97 @@ async function getWorkItemsByQuery(client, project, wiql) {
     const ids = (queryResult.workItems ?? []).map((ref) => ref.id).filter(Boolean);
     return getWorkItemsByIds(client, project, ids);
 }
+/**
+ * Return a planner-agent-optimised view of a single User Story.
+ * Includes related TC IDs (already written), suggested tags, and extracted actors.
+ */
+async function getStoryContext(client, project, storyId, orgUrl) {
+    const witApi = await client.getWitApi();
+    // Fetch with relations expanded (4 = WorkItemExpand.Relations)
+    const wi = await witApi.getWorkItem(storyId, undefined, undefined, 4);
+    const f = wi?.fields ?? {};
+    const rawTitle = f['System.Title'] ?? `Work Item ${storyId}`;
+    const rawDesc = f['System.Description'];
+    const rawAc = f['Microsoft.VSTS.Common.AcceptanceCriteria'];
+    const rawTags = f['System.Tags'] ?? '';
+    const description = stripHtml(rawDesc);
+    const acceptanceCriteria = stripHtml(rawAc);
+    // AC bullet items — split on newlines, strip list markers, drop blank lines
+    const acItems = (acceptanceCriteria ?? '')
+        .split('\n')
+        .map((l) => l.replace(/^[-*•\d.)\s]+/, '').trim())
+        .filter((l) => l.length > 0);
+    const adoTags = rawTags
+        ? rawTags.split(';').map((t) => t.trim()).filter(Boolean)
+        : [];
+    // Extract related TC IDs from relations
+    const relations = wi?.relations ?? [];
+    const relatedTestCases = relations
+        .filter((r) => typeof r.rel === 'string' && r.rel.includes('TestedBy'))
+        .map((r) => {
+        const match = (r.url ?? '').match(/\/(\d+)$/);
+        return match ? parseInt(match[1], 10) : NaN;
+    })
+        .filter((id) => !isNaN(id));
+    const searchText = [rawTitle, acceptanceCriteria ?? '', description ?? ''].join(' ').toLowerCase();
+    const suggestedTags = inferTags(searchText);
+    const suggestedActors = extractActors(acceptanceCriteria ?? '');
+    const url = `${orgUrl.replace(/\/$/, '')}/${project}/_workitems/edit/${storyId}`;
+    return {
+        storyId,
+        title: rawTitle,
+        description,
+        acceptanceCriteria,
+        acItems,
+        state: f['System.State'],
+        adoTags: adoTags.length ? adoTags : undefined,
+        suggestedTags,
+        suggestedActors,
+        relatedTestCases,
+        url,
+    };
+}
+// ─── Tag inference ────────────────────────────────────────────────────────────
+const TAG_RULES = [
+    { patterns: /\bsmoke\b/, tag: '@smoke' },
+    { patterns: /\bregression\b/, tag: '@regression' },
+    { patterns: /\b(login|sign[- ]?in|sign[- ]?out|log[- ]?out|auth(entication|oriz)?)\b/, tag: '@auth' },
+    { patterns: /\b(payment|checkout|billing|invoice|refund)\b/, tag: '@payment' },
+    { patterns: /\b(performance|load test|speed|latency)\b/, tag: '@performance' },
+    { patterns: /\bmobile\b/, tag: '@mobile' },
+    { patterns: /\b(api|endpoint|rest|graphql|webhook)\b/, tag: '@api' },
+    { patterns: /\b(security|permission|role|access control)\b/, tag: '@security' },
+    { patterns: /\b(search|filter|sort)\b/, tag: '@search' },
+    { patterns: /\b(upload|download|file|attachment)\b/, tag: '@files' },
+    { patterns: /\b(notification|email|sms|alert)\b/, tag: '@notifications' },
+    { patterns: /\b(report|export|csv|excel|pdf)\b/, tag: '@reporting' },
+    { patterns: /\bcritical\b/, tag: '@critical' },
+    { patterns: /\bwip\b/, tag: '@wip' },
+];
+function inferTags(text) {
+    return TAG_RULES
+        .filter((r) => r.patterns.test(text))
+        .map((r) => r.tag);
+}
+// ─── Actor extraction ─────────────────────────────────────────────────────────
+function extractActors(ac) {
+    const found = new Set();
+    // "As a <actor>" / "As an <actor>"
+    for (const m of ac.matchAll(/\bas an?\s+([a-z][a-z\s]{1,25}?)(?:,|\.|I |can |should |must )/gi)) {
+        const actor = m[1].trim().replace(/\s+/g, ' ');
+        if (actor)
+            found.add(actor);
+    }
+    // "the <actor> can/should/must"
+    for (const m of ac.matchAll(/\bthe\s+([a-z][a-z\s]{1,20}?)\s+(?:can|should|must|is able to)\b/gi)) {
+        const actor = m[1].trim().replace(/\s+/g, ' ');
+        if (actor && actor.split(' ').length <= 3)
+            found.add(actor);
+    }
+    // Deduplicate substrings (e.g. "admin" vs "admin user" — keep longer)
+    const actors = [...found];
+    return actors.filter((a) => !actors.some((b) => b !== a && b.includes(a)));
+}
 /**
  * Fetch User Stories under a specific area path.
  */

package/dist/azure/work-items.js.map

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

package/dist/cli.js

@@ -58,6 +58,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();
@@ -337,13 +338,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 +372,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 +387,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);
@@ -609,12 +639,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 +657,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 +736,52 @@ 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);
+    }
+});
 // ─── Run ─────────────────────────────────────────────────────────────────────
 program.parse(process.argv);
 //# sourceMappingURL=cli.js.map