ticketlens 0.1.18 → 0.1.20

package/README.md

@@ -160,6 +160,62 @@ Bot comments (Jira Automation, Jenkins, GitHub Actions) are automatically ignore
 
 ---
 
+### Review
+
+```bash
+ticketlens review                             # Assemble PR review context from current branch
+ticketlens review --branch=main              # Compare against main (auto-detected by default)
+ticketlens review --branch=develop           # Compare against a specific branch
+ticketlens review --base=main                # Alias for --branch
+ticketlens review --profile=acme             # Use a specific profile for ticket fetching
+ticketlens review --branch=main | pbcopy     # Copy brief to clipboard
+ticketlens review --branch=main | llm "What changed and why?"
+ticketlens review --help                     # Review subcommand help
+```
+
+Extracts linked ticket keys from the branch name and commit messages, fetches each ticket via the configured profile, then assembles a structured brief: branch, changed files, and ticket context. On TTY, output is ANSI-styled with colored section headers, file paths, and coverage percentages.
+
+`--branch=BRANCH` (or `--base=BRANCH`) sets the comparison base. Defaults to auto-detecting `main`, `master`, or `develop`.
+
+Flag validation provides actionable hints:
+
+```
+✖ Unknown flag: --branch-main
+  Did you mean --branch=main?
+```
+
+---
+
+### Standup
+
+```bash
+ticketlens standup                            # Standup summary for the last 24 hours
+ticketlens standup --since=48                 # Last 48 hours
+ticketlens standup --since=yesterday          # Git date string
+ticketlens standup --format=pr               # PR body format: "What changed" + commit list
+ticketlens standup --profile=myteam          # Enrich with ticket summaries from Jira
+ticketlens standup --plain                   # Plain markdown (no ANSI colour)
+ticketlens standup --plain | pbcopy          # Copy standup to clipboard
+ticketlens standup --help                    # Standup subcommand help
+```
+
+Scans `git log` for the configured window, extracts ticket keys from commit messages, and groups commits by ticket. Optionally fetches ticket summaries from your Jira profile to add context. Outputs a dated standup brief or a PR body depending on `--format`.
+
+```
+## Standup — Mon, May 18, 2026
+
+### Commits by ticket
+
+**PROJ-123** — Fix payment validation (2 commits)
+  abc1234 feat: PROJ-123 add payment validation check
+  def5678 test: PROJ-123 payment validation tests
+
+[No ticket key] (1 commit)
+  jkl3456 chore: bump deps
+```
+
+---
+
 ### Cache
 
 ```bash
@@ -303,6 +359,25 @@ ticketlens triage --profile=acme --stale=3 --static          # Combine flags
 ticketlens triage --plain > my-tickets.md
 ticketlens triage --plain | llm "Which ticket is most urgent and why?"
 
+# ── PR Review ─────────────────────────────────────────────────────────────────
+ticketlens review                             # Assemble PR review context from current branch
+ticketlens review --branch=main              # Compare against main (auto-detected by default)
+ticketlens review --branch=develop           # Compare against a specific branch
+ticketlens review --base=main                # Alias for --branch
+ticketlens review --profile=acme             # Use a specific profile for ticket fetching
+ticketlens review --branch=main | pbcopy     # Copy brief to clipboard
+ticketlens review --branch=main --profile=myteam  # Branch + profile combined
+ticketlens review --help                     # Review subcommand help
+
+# ── Standup ───────────────────────────────────────────────────────────────────
+ticketlens standup                            # Standup summary for last 24 hours
+ticketlens standup --since=48                 # Last 48 hours
+ticketlens standup --since=yesterday          # Git date string
+ticketlens standup --format=pr               # PR body: "What changed" + commit list
+ticketlens standup --profile=myteam          # Enrich with Jira ticket summaries
+ticketlens standup --plain | pbcopy          # Copy to clipboard
+ticketlens standup --help                    # Standup subcommand help
+
 # ── Cache management ──────────────────────────────────────────────────────────
 ticketlens cache                              # Overview + subcommand hints
 ticketlens cache --help                       # Detailed help
@@ -337,6 +412,7 @@ ticketlens --help                             # Main help
 ticketlens --version                          # Show installed version
 ticketlens CNV1-2 --help                     # Fetch subcommand help
 ticketlens triage --help                      # Triage subcommand help
+ticketlens review --help                      # Review subcommand help
 ticketlens cache --help                       # Cache overview help
 ticketlens cache size --help                  # Cache size help
 ticketlens cache clear --help                 # Cache clear help
@@ -458,14 +534,12 @@ npm test
 See [ROADMAP.md](ROADMAP.md) for the full plan.
 
 Recently shipped:
+- **"TicketLens for PRs"** (`ticketlens review`) — assembles a code-review context brief from your current branch: extracts linked ticket keys from the branch name and commits, fetches each ticket, and outputs a structured brief with branch, changed files, and ticket context. Styled ANSI output, spinner, flag validation with typo hints, and base-branch safety check
 - **Confluence pages** — linked Confluence pages fetched automatically and included in the brief; origin-validated, non-fatal, capped at 10 pages
 - **Linear support** — `ticketlens init` → Linear; connects via GraphQL API key, fetches tickets, triage, and statuses
 - **GitHub Issues support** — `ticketlens init` → GitHub Issues; PAT-based, same normalized ticket shape
 - **Tracker-aware config** — `ticketlens config` shows the right labels and skips irrelevant prompts per tracker type; always re-validates the connection
 
-Coming up:
-- "TicketLens for PRs" — PR context assembly with linked tickets and compliance (F46)
-
 ---
 
 ## Contributing

package/bin/ticketlens.mjs

@@ -23,7 +23,7 @@ import {
   printActivateHelp, printLicenseHelp, printDeleteHelp,
   printProfilesHelp, printScheduleHelp,
   printInitHelp, printSwitchHelp, printConfigHelp,
-  printReviewHelp,
+  printReviewHelp, printStandupHelp,
 } from '../skills/jtb/scripts/lib/help.mjs';
 import { createStyler } from '../skills/jtb/scripts/lib/ansi.mjs';
 import { readCliToken, saveCliToken, deleteCliToken } from '../skills/jtb/scripts/lib/cli-auth.mjs';
@@ -271,6 +271,14 @@ switch (command) {
     });
     break;
 
+  case 'standup':
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printStandupHelp(); break; }
+    runFetch(['standup', ...cmdArgs]).catch(err => {
+      process.stderr.write(`Error: ${err.message}\n`);
+      process.exitCode = 1;
+    });
+    break;
+
   case 'ledger':
     runFetch(['ledger', ...cmdArgs]).catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Jira CLI for developers — fetch ticket context, triage your queue, and stop tab-switching. Zero dependencies, all local.",
   "type": "module",
   "bin": {

package/skills/jtb/scripts/fetch-ticket.mjs

@@ -630,6 +630,135 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
     return;
   }
 
+  if (args[0] === 'standup') {
+    const { groupCommitsByTicket, assembleStandup, styleStandupMd, VALID_STANDUP_FLAG } =
+      await import('./lib/standup-assembler.mjs');
+
+    const resolvedConfigDir = configDir ?? (await import('./lib/config.mjs')).DEFAULT_CONFIG_DIR;
+    const execFn = opts.execFn ?? spawnSync;
+    const cwd = process.cwd();
+    const sErr = createStyler({ isTTY: process.stderr.isTTY });
+
+    const standupFlags = args.slice(1);
+
+    // Validate flags
+    for (const flag of standupFlags) {
+      if (!flag.startsWith('-')) continue;
+      if (VALID_STANDUP_FLAG.test(flag)) continue;
+
+      const sinceDashM = flag.match(/^--since-(.+)$/);
+      if (sinceDashM) {
+        process.stderr.write(`${sErr.red('✖')} Unknown flag: ${sErr.bold(flag)}\n  Did you mean ${sErr.cyan(`--since=${sinceDashM[1]}`)}?\n`);
+        process.exitCode = 1;
+        return;
+      }
+      const formatDashM = flag.match(/^--format-(.+)$/);
+      if (formatDashM) {
+        process.stderr.write(`${sErr.red('✖')} Unknown flag: ${sErr.bold(flag)}\n  Did you mean ${sErr.cyan(`--format=${formatDashM[1]}`)}?\n`);
+        process.exitCode = 1;
+        return;
+      }
+      const profileDashM = flag.match(/^--profile-(.+)$/);
+      if (profileDashM) {
+        process.stderr.write(`${sErr.red('✖')} Unknown flag: ${sErr.bold(flag)}\n  Did you mean ${sErr.cyan(`--profile=${profileDashM[1]}`)}?\n`);
+        process.exitCode = 1;
+        return;
+      }
+      const formatValueM = flag.match(/^--format=(.+)$/);
+      if (formatValueM) {
+        process.stderr.write(`${sErr.red('✖')} Invalid --format value: "${formatValueM[1]}". Expected: standup or pr\n`);
+        process.exitCode = 1;
+        return;
+      }
+      process.stderr.write(`${sErr.red('✖')} Unknown flag: ${sErr.bold(flag)}\n  Usage: ${sErr.cyan('ticketlens standup [--since=N] [--format=standup|pr] [--profile=NAME]')}\n`);
+      process.exitCode = 1;
+      return;
+    }
+
+    // --format value
+    const formatArgS = standupFlags.find(a => a.startsWith('--format='));
+    const format = formatArgS ? formatArgS.split('=')[1] : 'standup';
+
+    // --since: integer → "N hours ago", otherwise pass verbatim to git --since
+    const sinceArgS = standupFlags.find(a => a.startsWith('--since='));
+    const sinceVal = sinceArgS ? sinceArgS.split('=').slice(1).join('=') : '24';
+    const sinceDateStr = /^\d+$/.test(sinceVal) ? `${sinceVal} hours ago` : sinceVal;
+
+    // --profile
+    const profileArgS = standupFlags.find(a => a.startsWith('--profile='));
+    const profileNameS = profileArgS ? profileArgS.split('=')[1] : undefined;
+
+    if (profileNameS) {
+      const profiles = loadProfiles(resolvedConfigDir);
+      if (!profiles?.profiles?.[profileNameS]) {
+        process.stderr.write(`${sErr.red('✖')} Profile "${profileNameS}" not found.\n`);
+        const names = Object.keys(profiles?.profiles ?? {});
+        if (names.length > 0) process.stderr.write(`  ${sErr.dim('Available:')} ${names.join(', ')}\n`);
+        else process.stderr.write(`  Run ${sErr.cyan('ticketlens init')} to configure a profile.\n`);
+        process.exitCode = 1;
+        return;
+      }
+    }
+
+    const spinner = makeSpinner(sErr);
+    const stderrNotes = [];
+
+    spinner.update('Scanning git log…');
+
+    const logResult = execFn('git', ['log', '--oneline', `--since=${sinceDateStr}`], {
+      encoding: 'utf8', cwd, timeout: 10_000,
+    });
+    const logLines = logResult.status === 0
+      ? (logResult.stdout ?? '').split('\n').filter(Boolean)
+      : [];
+
+    if (logResult.status !== 0) {
+      stderrNotes.push(`  ${sErr.yellow('⚠')} git log failed — ensure you are in a git repository.`);
+    }
+
+    const groupCommitsFn = opts.groupCommitsByTicketFn ?? groupCommitsByTicket;
+    const groups = groupCommitsFn(logLines);
+    const ticketKeys = [...groups.keys()].filter(k => k !== '__no_key__');
+
+    // Optionally fetch ticket summaries
+    const tickets = [];
+    if (ticketKeys.length > 0) {
+      spinner.update(`Fetching ticket context (${ticketKeys.length} key${ticketKeys.length > 1 ? 's' : ''})…`);
+      spinner.startAnim();
+      const connS = resolveConnection(ticketKeys[0], {
+        env,
+        configDir: resolvedConfigDir,
+        profileName: profileNameS,
+        cwd,
+        onWarning: () => {},
+        onProfileNotFound: () => {},
+      });
+      const hasAuthS = connS.pat || (connS.email && connS.apiToken);
+      if (connS.baseUrl && hasAuthS) {
+        const adapterS = resolveAdapter(connS, { fetcher });
+        for (const key of ticketKeys) {
+          try {
+            tickets.push(await adapterS.fetchTicket(key, { depth: 0 }));
+          } catch (err) {
+            stderrNotes.push(`  ${sErr.yellow('⚠')} ${key}: ${err.message ?? 'fetch failed'}`);
+          }
+        }
+      }
+    }
+
+    spinner.done();
+    for (const note of stderrNotes) process.stderr.write(note + '\n');
+    if (stderrNotes.length > 0) process.stderr.write('\n');
+
+    const isPlain = standupFlags.includes('--plain');
+    const assembleStandupFn = opts.assembleStandupFn ?? assembleStandup;
+    const md = assembleStandupFn(groups, tickets, { since: sinceVal, format });
+
+    const sOut = createStyler({ isTTY: !isPlain && process.stdout.isTTY });
+    printFn((sOut.enabled ? styleStandupMd(md, sOut) : md) + '\n');
+    return;
+  }
+
   const ticketKey = args.find(a => !a.startsWith('--'));
   if (!ticketKey) {
     printFetchHelp({ stream: process.stderr });

package/skills/jtb/scripts/lib/cli.mjs

@@ -86,6 +86,10 @@ export function parseCommand(args) {
     return { command: 'review', args: args.slice(1) };
   }
 
+  if (first === 'standup') {
+    return { command: 'standup', args: args.slice(1) };
+  }
+
   if (first === 'login') {
     return { command: 'login', args: args.slice(1) };
   }

package/skills/jtb/scripts/lib/help.mjs

@@ -39,6 +39,7 @@ export function printHelp({ stream = process.stdout } = {}) {
     `    ${s.brand('ticketlens')} get ${s.dim('<TICKET-KEY>')}         Same as above ${s.dim('(explicit alias)')}`,
     `    ${s.brand('ticketlens')} triage ${s.dim('[options]')}         Scan your assigned tickets`,
     `    ${s.brand('ticketlens')} review ${s.dim('[--branch=BRANCH]')}   Code-review context brief from current branch`,
+    `    ${s.brand('ticketlens')} standup ${s.dim('[--since=N]')}        Standup summary from git log  ${s.dim('(last 24h by default)')}`,
     `    ${s.brand('ticketlens')} compliance ${s.dim('<TICKET-KEY>')}    Check requirements coverage  ${s.dim('[Pro/Free 3/mo]')}`,
     '',
     `    ${s.brand('ticketlens')} delete ${s.dim('<PROFILE-NAME>')}     Remove a profile`,
@@ -575,3 +576,35 @@ export function printReviewHelp({ stream = process.stdout } = {}) {
   ];
   stream.write(lines.join('\n') + '\n');
 }
+
+export function printStandupHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('standup')} ${s.dim('[--since=N] [--format=standup|pr] [--profile=NAME] [--plain]')}`,
+    '',
+    `  Generate a standup summary or PR body from your recent git commits.`,
+    `  Reads git log for the last 24 hours, groups commits by ticket key,`,
+    `  and optionally enriches output with ticket summaries via a Jira profile.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--since')}=${s.dim('N')}          Look back N hours  ${s.dim('(default: 24)')}`,
+    `                       Also accepts git date strings: ${s.dim('--since=yesterday')}, ${s.dim('--since=2024-01-15')}`,
+    `    ${s.brand('--format')}=${s.dim('standup')}   Bullet list grouped by ticket  ${s.dim('(default)')}`,
+    `    ${s.brand('--format')}=${s.dim('pr')}        PR body: "What changed" + commit list`,
+    `    ${s.brand('--profile')}=${s.dim('NAME')}  Use a specific tracker profile to fetch ticket summaries`,
+    `    ${s.brand('--plain')}           Plain markdown output ${s.dim('(no ANSI colour)')}`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}      Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens standup`,
+    `    ${s.dim('$')} ticketlens standup --since=48`,
+    `    ${s.dim('$')} ticketlens standup --format=pr`,
+    `    ${s.dim('$')} ticketlens standup --profile=myteam`,
+    `    ${s.dim('$')} ticketlens standup --plain | pbcopy  ${s.dim('# copy standup to clipboard')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}

package/skills/jtb/scripts/lib/standup-assembler.mjs

@@ -0,0 +1,133 @@
+import { extractTicketKeys } from './pr-review-assembler.mjs';
+
+export const VALID_STANDUP_FLAG = /^(--since=.+|--format=(standup|pr)|--profile=.+|--plain)$/;
+
+export function groupCommitsByTicket(logLines) {
+  const groups = new Map();
+  for (const line of logLines) {
+    if (!line.trim()) continue;
+    const keys = extractTicketKeys(line);
+    if (keys.length === 0) {
+      const bucket = groups.get('__no_key__') ?? [];
+      bucket.push(line);
+      groups.set('__no_key__', bucket);
+    } else {
+      for (const key of keys) {
+        const bucket = groups.get(key) ?? [];
+        if (!bucket.includes(line)) bucket.push(line);
+        groups.set(key, bucket);
+      }
+    }
+  }
+  return groups;
+}
+
+function assemblePrBody(groups, ticketMap) {
+  const lines = ['## What changed', ''];
+  const keyedGroups = [...groups.entries()].filter(([k]) => k !== '__no_key__');
+  if (keyedGroups.length === 0) {
+    lines.push('_No ticket references found in commits._');
+  } else {
+    for (const [key] of keyedGroups) {
+      const ticket = ticketMap.get(key);
+      const summary = ticket?.fields?.summary ?? ticket?.summary ?? null;
+      lines.push(summary ? `- **${key}** — ${summary}` : `- **${key}**`);
+    }
+  }
+  const seen = new Set();
+  const allCommits = [];
+  for (const commits of groups.values()) {
+    for (const c of commits) {
+      if (!seen.has(c)) { seen.add(c); allCommits.push(c); }
+    }
+  }
+  lines.push('', `## Commits (${allCommits.length})`, '');
+  for (const c of allCommits) {
+    const trimmed = c.trim();
+    const shaM = trimmed.match(/^([0-9a-f]{6,})\s(.+)$/);
+    lines.push(shaM ? `- \`${shaM[1]}\` ${shaM[2]}` : `- ${trimmed}`);
+  }
+  return lines.join('\n');
+}
+
+export function assembleStandup(groups, tickets, opts = {}) {
+  const { since = '24', format = 'standup' } = opts;
+  const ticketMap = new Map((tickets ?? []).map(t => [t.key, t]));
+
+  if (format !== 'standup' && format !== 'pr') throw new Error(`Unknown standup format: "${format}"`);
+  if (format === 'pr') return assemblePrBody(groups, ticketMap);
+
+  const dateStr = new Date().toLocaleDateString('en-US', {
+    weekday: 'short', day: 'numeric', month: 'short', year: 'numeric',
+  });
+  const lines = [`## Standup — ${dateStr}`, ''];
+
+  const keyedGroups = [...groups.entries()].filter(([k]) => k !== '__no_key__');
+  const noKeyCommits = groups.get('__no_key__') ?? [];
+
+  if (keyedGroups.length === 0 && noKeyCommits.length === 0) {
+    const hourLabel = /^\d+$/.test(since)
+      ? `${since} hour${since === '1' ? '' : 's'}`
+      : since;
+    lines.push(`_No commits in the last ${hourLabel}._`);
+    return lines.join('\n');
+  }
+
+  if (keyedGroups.length > 0) {
+    lines.push('### Commits by ticket', '');
+    for (const [key, commits] of keyedGroups) {
+      const ticket = ticketMap.get(key);
+      const summary = ticket?.fields?.summary ?? ticket?.summary ?? null;
+      const count = commits.length;
+      const countStr = `${count} commit${count > 1 ? 's' : ''}`;
+      const header = summary
+        ? `**${key}** — ${summary} (${countStr})`
+        : `**${key}** (${countStr})`;
+      lines.push(header);
+      for (const c of commits) lines.push(`  ${c.trim()}`);
+      lines.push('');
+    }
+  }
+
+  if (noKeyCommits.length > 0) {
+    const count = noKeyCommits.length;
+    lines.push(`[No ticket key] (${count} commit${count > 1 ? 's' : ''})`);
+    for (const c of noKeyCommits) lines.push(`  ${c.trim()}`);
+    lines.push('');
+  }
+
+  return lines.join('\n').trimEnd();
+}
+
+export function styleStandupMd(md, s) {
+  if (!s.enabled) return md;
+  return md
+    .split('\n')
+    .map(line => {
+      if (line.startsWith('## Standup')) {
+        return `\n  ${s.brand(s.bold('◆  ' + line.slice(3)))}`;
+      }
+      if (line.startsWith('## What changed')) {
+        return `\n  ${s.brand(s.bold('◆  What changed'))}`;
+      }
+      if (line.match(/^## Commits \(\d+\)/)) {
+        return `\n  ${s.bold(line.slice(3))}`;
+      }
+      if (line.startsWith('### ')) {
+        return `\n  ${s.bold(line.slice(4))}`;
+      }
+      const tkM = line.match(/^\*\*([A-Z][A-Z0-9]+-\d+)\*\*(.*)$/);
+      if (tkM) {
+        return `  ${s.cyan(s.bold(tkM[1]))}${tkM[2]}`;
+      }
+      if (line.startsWith('[No ticket key]')) {
+        return `  ${s.dim(line)}`;
+      }
+      if (line.startsWith('  ')) {
+        const shaM = line.trimStart().match(/^([0-9a-f]{6,})\s(.+)$/);
+        if (shaM) return `  ${s.dim(shaM[1])} ${shaM[2]}`;
+      }
+      return line;
+    })
+    .join('\n');
+}