ticketlens 0.8.1 → 0.9.2

package/README.md

@@ -102,6 +102,7 @@ ticketlens CNV1-2 --summarize --provider=groq  # Force a specific AI provider [P
 ticketlens CNV1-2 --summarize --cloud          # AI summary routed through TicketLens API [Pro]
 ticketlens CNV1-2 --handoff                    # AI handoff brief from comment thread (BYOK) [Pro]
 ticketlens CNV1-2 --handoff --cloud            # AI handoff brief via TicketLens API [Pro]
+ticketlens CNV1-2 --template=quick             # Apply a brief template (full|quick|code-review, or custom [Team])
 ```
 
 | `--depth` | Scope |
@@ -528,6 +529,9 @@ ticketlens CNV1-2 --summarize --provider=groq   # Force Groq (Llama 3.1, free ti
 ticketlens CNV1-2 --summarize --cloud           # AI summary via TicketLens API [Pro]
 ticketlens CNV1-2 --handoff                     # AI handoff brief from comment thread (BYOK) [Pro]
 ticketlens CNV1-2 --handoff --cloud             # AI handoff brief via TicketLens API [Pro]
+ticketlens CNV1-2 --template=quick              # Apply quick template (meta + 2 comments only)
+ticketlens CNV1-2 --template=code-review        # Apply code-review template (meta + desc + linked + code refs)
+ticketlens CNV1-2 --template=full               # Apply full template (all sections, default)
 ticketlens CNV1-2 --depth=2 --profile=acme --plain   # Combine flags freely
 
 # Pipe plain output to clipboard, LLM, or file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.8.1",
+  "version": "0.9.2",
   "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/SKILL.md

@@ -1,4 +1,4 @@
-<!-- jtb-skill-version: 0.8.0 -->
+<!-- jtb-skill-version: 0.9.1 -->
 ---
 name: jtb
 description: Fetch a Jira ticket's full context (description, comments, linked issues, code references) and assemble a structured TicketBrief for implementation planning. Use when user types /jtb, mentions a Jira ticket key, or wants to plan work from a Jira ticket.
@@ -23,6 +23,9 @@ Fetches a Jira ticket and produces a structured brief with code references, then
 /jtb PROD-1234 --summarize             # AI summary of the brief (Pro)
 /jtb PROD-1234 --summarize --cloud     # summary via TicketLens cloud (Pro)
 /jtb PROD-1234 --handoff               # structured handoff brief from comments (Pro)
+/jtb PROD-1234 --template=quick        # apply quick template (meta + 2 comments only)
+/jtb PROD-1234 --template=code-review  # apply code-review template (meta + desc + linked + code refs)
+/jtb PROD-1234 --template=full         # apply full template (all sections, default)
 /jtb triage                            # scan your assigned tickets for attention
 /jtb triage --stale=3                  # custom aging threshold (days)
 /jtb triage --status=CR,QA             # only check specific statuses
@@ -72,6 +75,12 @@ node ~/.agents/skills/jtb/scripts/fetch-my-tickets.mjs $EXTRA_ARGS
 
 Where `$EXTRA_ARGS` are any flags passed (e.g. `--stale=3 --status=QA --profile=acme`).
 
+**Urgency levels** (highest → lowest priority):
+- 🔴 `needs-response` — someone commented and you haven't replied
+- 🟡 `aging` — no activity for ≥ `staleDays` (default 5d)
+- 🔵 `stale` — ticket stuck in the same Jira status for ≥ N days (Pro — requires a stale rule configured in the Console)
+- 🟢 `clear` — up to date, no action needed
+
 **IMPORTANT:** Copy the script's stdout and display it directly as your response text (not inside a tool result). This ensures the markdown table renders visibly and URLs are clickable in the terminal. No VCS enrichment, no plan mode. Stop here.
 
 ---

package/skills/jtb/scripts/fetch-my-tickets.mjs

@@ -293,8 +293,13 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
   session.spin(`Connecting to ${session.label}…`);
 
   // Fire both requests concurrently — they are independent of each other
+  // expandChangelog is derived from staleRule, which the sync API only sends to Pro/Team/Enterprise
+  // users. A user who manually adds staleRule to their local profile.json would still expand
+  // their own Jira data — that is acceptable (Jira credentials are theirs; we gate TicketLens
+  // features server-side, not Jira API access).
+  const expandChangelog = !!(conn.staleRule?.enabled);
   const userPromise = adapter.fetchCurrentUser();
-  const ticketsPromise = adapter.searchTickets(jql);
+  const ticketsPromise = adapter.searchTickets(jql, { expandChangelog });
 
   let currentUser;
   try {
@@ -407,7 +412,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
     process.stderr.write(`Viewing ${assigneeName}'s tickets\n\n`);
   }
 
-  const scored = tickets.map(t => scoreAttention(t, effectiveUser, { staleDays, customRules: conn.attentionRules }));
+  const scored = tickets.map(t => scoreAttention(t, effectiveUser, { staleDays, customRules: conn.attentionRules, staleRule: conn.staleRule ?? null }));
   const actionable = scored.filter(s => s.urgency !== 'clear' && s.urgency !== 'ignore');
   const sorted = sortByUrgency(actionable);
   const rawTicketMap = new Map(tickets.map(t => [t.key, t]));

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

@@ -24,6 +24,8 @@ import { handleUnknownFlags } from './lib/arg-validator.mjs';
 import { TICKET_KEY_PATTERN } from './lib/cli.mjs';
 import { downloadAttachments } from './lib/attachment-downloader.mjs';
 import { readBriefCache, writeBriefCache, briefCacheAge, BRIEF_TTL_MS } from './lib/brief-cache.mjs';
+import { readCliToken } from './lib/cli-auth.mjs';
+import { resolveTemplate } from './lib/template-resolver.mjs';
 import { parseAge } from './lib/cache-manager.mjs';
 import { createStyler } from './lib/ansi.mjs';
 import { isLicensed, showUpgradePrompt, readLicense } from './lib/license.mjs';
@@ -836,12 +838,27 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
 
   const validatedArgs = await handleUnknownFlags(
     args,
-    ['--help', '-h', '--plain', '--styled', '--no-attachments', '--no-cache', '--profile=', '--depth=', '--check', '--summarize', '--cloud', '--compliance', '--budget=', '--handoff', '--provider='],
+    ['--help', '-h', '--plain', '--styled', '--no-attachments', '--no-cache', '--profile=', '--depth=', '--check', '--summarize', '--cloud', '--compliance', '--budget=', '--handoff', '--provider=', '--template='],
     { hints: ['--stale=', '--status=', '--static'] } // triage-only flags — shown as hints, not applied
   );
   if (validatedArgs === null) { process.exitCode = 1; return; }
   args = validatedArgs;
 
+  // Resolve --template= before cache check so both paths share the same sections.
+  const templateArg = args.find(a => a.startsWith('--template='));
+  let templateSections = null;
+  if (templateArg) {
+    const templateSlug = templateArg.split('=')[1];
+    try {
+      const tpl = await resolveTemplate(templateSlug, { token: readCliToken(configDir), fetcher });
+      templateSections = tpl.sections;
+    } catch (err) {
+      process.stderr.write(`Error: ${err.message}\n`);
+      process.exitCode = 1;
+      return;
+    }
+  }
+
   // When multiple profiles share the same ticket prefix and we're in a TTY,
   // ask the user to choose rather than silently picking the first match.
   if (!profileName && process.stderr.isTTY && process.stdin.setRawMode) {
@@ -942,7 +959,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
 
       // Apply --budget pruning on the plain brief before styling (Pro only).
       // When --budget is active, always output plain text (pruning operates on unescaped chars).
-      let plainBrief = assembleBrief(cached.ticket, codeRefs);
+      let plainBrief = assembleBrief(cached.ticket, codeRefs, templateSections);
       const budgetArgCached = args.find(a => a.startsWith('--budget='));
       if (budgetArgCached) {
         const budgetN = parseInt(budgetArgCached.split('=')[1], 10);
@@ -956,7 +973,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
       }
       let brief = (budgetArgCached && licensedFn('pro', configDir))
         ? plainBrief
-        : (useStyled ? styleBrief(cached.ticket, codeRefs, { styled: true }) : plainBrief);
+        : (useStyled ? styleBrief(cached.ticket, codeRefs, { styled: true, templateSections }) : plainBrief);
 
       if (args.includes('--handoff')) {
         const handoffResult = await applyHandoff(cached.ticket, args, opts, configDir, licensedFn, upgradeFn);
@@ -1128,7 +1145,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
 
   // Apply --budget pruning on the plain brief before styling (Pro only).
   // When --budget is active, always output plain text (pruning operates on unescaped chars).
-  let plainOutput = assembleBrief(ticket, codeRefs);
+  let plainOutput = assembleBrief(ticket, codeRefs, templateSections);
   const budgetArg = args.find(a => a.startsWith('--budget='));
   if (budgetArg) {
     const budgetN = parseInt(budgetArg.split('=')[1], 10);
@@ -1142,7 +1159,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
   }
   let output = (budgetArg && licensedFn('pro', configDir))
     ? plainOutput
-    : (useStyled ? styleBrief(ticket, codeRefs, { styled: true }) : plainOutput);
+    : (useStyled ? styleBrief(ticket, codeRefs, { styled: true, templateSections }) : plainOutput);
 
   if (args.includes('--handoff')) {
     const handoffResult = await applyHandoff(ticket, args, opts, configDir, licensedFn, upgradeFn);

package/skills/jtb/scripts/lib/api-utils.mjs

@@ -3,7 +3,7 @@
  * Centralised here to avoid triplicating the regex and warning logic.
  */
 
-export const DEFAULT_API_BASE = 'http://ticketlens.test';
+export const DEFAULT_API_BASE = 'https://api.ticketlens.app';
 
 // Matches localhost, 127.0.0.1, and any hostname ending in .test or .local,
 // with an optional port — all treated as local-only addresses.

package/skills/jtb/scripts/lib/attention-scorer.mjs

@@ -97,7 +97,7 @@ function applyCustomRule(ticket, rule) {
 }
 
 export function scoreAttention(ticket, currentUser, opts = {}) {
-  const { staleDays = 5, now = new Date(), customRules } = opts;
+  const { staleDays = 5, now = new Date(), customRules, staleRule } = opts;
 
   // Custom rules evaluated first — first match wins
   if (Array.isArray(customRules)) {
@@ -162,6 +162,27 @@ export function scoreAttention(ticket, currentUser, opts = {}) {
     }
   }
 
+  // Stale check — only when rule is active and statusChangedAt was captured via changelog expand.
+  // Runs as final gate so needs-response and aging always take precedence.
+  if (staleRule?.enabled && ticket.statusChangedAt) {
+    const daysInCurrentStatus = (now - new Date(ticket.statusChangedAt)) / (1000 * 60 * 60 * 24);
+    if (
+      daysInCurrentStatus >= (staleRule.stale_days ?? 14) &&
+      Array.isArray(staleRule.statuses) &&
+      staleRule.statuses.includes(ticket.status)
+    ) {
+      return {
+        ticketKey: ticket.key,
+        summary: ticket.summary,
+        status: ticket.status,
+        urgency: 'stale',
+        reason: `Stuck in '${ticket.status}' for ${Math.floor(daysInCurrentStatus)}d`,
+        lastComment,
+        daysInCurrentStatus: Math.floor(daysInCurrentStatus),
+      };
+    }
+  }
+
   return {
     ticketKey: ticket.key,
     summary: ticket.summary,
@@ -172,7 +193,7 @@ export function scoreAttention(ticket, currentUser, opts = {}) {
   };
 }
 
-const URGENCY_ORDER = { 'needs-response': 0, 'aging': 1, 'clear': 2 };
+export const URGENCY_ORDER = { 'needs-response': 0, 'aging': 1, 'stale': 2, 'clear': 3 };
 
 export function sortByUrgency(scores) {
   return [...scores].sort((a, b) => {

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

@@ -6,7 +6,8 @@ import { formatTable } from './table-formatter.mjs';
 import { formatSize } from './attachment-downloader.mjs';
 import { timeAgo, truncate, stripCr } from './config.mjs';
 
-export function assembleBrief(ticket, codeRefs = null) {
+export function assembleBrief(ticket, codeRefs = null, templateSections = null) {
+  const s = templateSections;
   const sections = [];
   sections.push(`# ${ticket.key}: ${ticket.summary}`);
 
@@ -15,19 +16,25 @@ export function assembleBrief(ticket, codeRefs = null) {
   if (ticket.updated) meta.push(`**Updated:** ${ticket.updated.split('T')[0]}`);
   sections.push(meta.join(' | '));
 
-  if (ticket.description) {
+  if (ticket.description && (s === null || s.description !== false)) {
     sections.push(`## Description\n\n${stripCr(ticket.description)}`);
   }
 
-  if (ticket.comments?.length > 0) {
-    const commentLines = ticket.comments.map(c => {
+  const commentsEnabled = s === null || s.comments?.enabled !== false;
+  const rawMax          = s?.comments?.max;
+  const commentsMax     = (typeof rawMax === 'number' && rawMax >= 0) ? rawMax : Infinity;
+  const visibleComments = commentsEnabled && ticket.comments?.length > 0
+    ? ticket.comments.slice(0, commentsMax === Infinity ? ticket.comments.length : commentsMax)
+    : [];
+  if (visibleComments.length > 0) {
+    const commentLines = visibleComments.map(c => {
       const date = c.created ? c.created.split('T')[0] : 'unknown';
       return `### **${c.author}** (${date})\n\n${c.body.replace(/\r/g, '')}`;
     });
     sections.push(`## Comments\n\n${commentLines.join('\n\n---\n\n')}`);
   }
 
-  if (ticket.linkedTicketDetails?.length > 0) {
+  if (ticket.linkedTicketDetails?.length > 0 && (s === null || s.linked !== false)) {
     const linkedSections = ticket.linkedTicketDetails.map(lt => {
       const parts = [`### ${lt.key}: ${lt.summary}`, `**Type:** ${lt.type} | **Status:** ${lt.status}`];
       if (lt.description) parts.push(stripCr(lt.description));
@@ -43,7 +50,7 @@ export function assembleBrief(ticket, codeRefs = null) {
     sections.push(`## Linked Tickets\n\n${linkedSections.join('\n\n---\n\n')}`);
   }
 
-  if (ticket.confluencePages?.length > 0) {
+  if (ticket.confluencePages?.length > 0 && (s === null || s.confluence !== false)) {
     const pageLines = ticket.confluencePages.map(p => {
       const parts = [`### ${p.title ?? p.url}`];
       if (p.text) parts.push(p.text);
@@ -52,7 +59,7 @@ export function assembleBrief(ticket, codeRefs = null) {
     sections.push(`## Confluence Pages\n\n${pageLines.join('\n\n---\n\n')}`);
   }
 
-  if (codeRefs) {
+  if (codeRefs && (s === null || s.code_refs !== false)) {
     const categories = [
       ['File Paths', codeRefs.filePaths],
       ['Methods', codeRefs.methods],
@@ -70,7 +77,7 @@ export function assembleBrief(ticket, codeRefs = null) {
     }
   }
 
-  if (ticket.attachments?.length > 0) {
+  if (ticket.attachments?.length > 0 && (s === null || s.attachments !== false)) {
     const lines = ticket.attachments.map(a => {
       const r = (ticket.localAttachments ?? []).find(x => x.filename === a.filename);
       const sz = formatSize(a.size);
@@ -103,6 +110,7 @@ export function assembleTriageSummary(scoredTickets, opts = {}) {
 
   const needsResponse = actionable.filter(t => t.urgency === 'needs-response');
   const aging = actionable.filter(t => t.urgency === 'aging');
+  const stale = actionable.filter(t => t.urgency === 'stale');
   const allKeys = [];
 
   if (needsResponse.length > 0) {
@@ -129,13 +137,28 @@ export function assembleTriageSummary(scoredTickets, opts = {}) {
       return [String(agingOffset + i + 1), t.ticketKey, truncate(t.summary, 50), t.status, `${days}d`];
     });
     const table = formatTable(
-      ['#', 'Ticket', 'Summary', 'Status', 'Stale'],
+      ['#', 'Ticket', 'Summary', 'Status', 'Idle'],
       tableRows,
       { maxWidths: { 2: 50 } },
     );
     sections.push(`Aging — no activity > ${staleDays} days (${aging.length})\n\n${table}`);
   }
 
+  if (stale.length > 0) {
+    const staleOffset = needsResponse.length + aging.length;
+    const tableRows = stale.map((t, i) => {
+      allKeys.push(t.ticketKey);
+      const days = t.daysInCurrentStatus ?? '?';
+      return [String(staleOffset + i + 1), t.ticketKey, truncate(t.summary, 50), t.status, `${days}d`];
+    });
+    const table = formatTable(
+      ['#', 'Ticket', 'Summary', 'Status', 'Stuck'],
+      tableRows,
+      { maxWidths: { 2: 50 } },
+    );
+    sections.push(`Stale — stuck in same status (${stale.length})\n\n${table}`);
+  }
+
   if (browseUrl && allKeys.length > 0) {
     const links = allKeys.map((k, i) => `[${i + 1}] ${k}: ${browseUrl}${k}`);
     sections.push(`Quick Links\n\n${links.join('\n')}`);

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

@@ -67,7 +67,8 @@ export function printHelp({ stream = process.stdout } = {}) {
     `    ${s.brand('--summarize')}        Generate AI summary ${s.dim('(BYOK or --cloud) [Pro]')}`,
     `    ${s.brand('--handoff')}          AI handoff brief from comment thread ${s.dim('(BYOK or --cloud) [Pro]')}`,
     `    ${s.brand('--cloud')}            Route AI request through TicketLens API ${s.dim('[Pro]')}`,
-    `    ${s.brand('--provider')}=${s.dim('NAME')}     Force AI provider ${s.dim('(anthropic|openai|groq)')}`,
+    `    ${s.brand('--provider')}=${s.dim('NAME')}    Force AI provider ${s.dim('(anthropic|openai|groq)')}`,
+    `    ${s.brand('--template')}=${s.dim('SLUG')}    Apply a brief template ${s.dim('(full|quick|code-review, or custom [Team])')}`,
     '',
     `  ${s.bold('TRIAGE OPTIONS')}`,
     '',
@@ -81,7 +82,7 @@ export function printHelp({ stream = process.stdout } = {}) {
     `    ${s.brand('--project')}=${s.dim('PROJ')}     Filter by Jira project key  ${s.dim('[Team]')}`,
     `    ${s.brand('--label')}=${s.dim('X,Y')}        Filter by label(s)  ${s.dim('[Team]')}`,
     `    ${s.brand('--priority')}=${s.dim('LEVEL')}   Filter by priority  ${s.dim('(e.g. High, Blocker) [Team]')}`,
-    `    ${s.brand('--export')}=${s.dim('FORMAT')}   Export results to file  ${s.dim('(csv|json) [Team]')}`,
+    `    ${s.brand('--export')}=${s.dim('FORMAT')}    Export results to file  ${s.dim('(csv|json) [Team]')}`,
     `    ${s.brand('--push')}             Push snapshot to Console queue  ${s.dim('[Team]')}`,
     `    ${s.brand('--share')}            Generate a 24h share URL  ${s.dim('(no login required) [Team]')}`,
     `    ${s.brand('--all')}              Triage all configured profiles at once  ${s.dim('[Pro]')}`,
@@ -149,7 +150,8 @@ export function printFetchHelp({ stream = process.stdout } = {}) {
     `    ${s.brand('--summarize')}        Generate AI summary ${s.dim('(BYOK or --cloud) [Pro]')}`,
     `    ${s.brand('--handoff')}          AI handoff brief from comment thread ${s.dim('(BYOK or --cloud) [Pro]')}`,
     `    ${s.brand('--cloud')}            Route AI request through TicketLens API ${s.dim('[Pro]')}`,
-    `    ${s.brand('--provider')}=${s.dim('NAME')}     Force AI provider ${s.dim('(anthropic|openai|groq)')}`,
+    `    ${s.brand('--provider')}=${s.dim('NAME')}    Force AI provider ${s.dim('(anthropic|openai|groq)')}`,
+    `    ${s.brand('--template')}=${s.dim('SLUG')}    Apply a brief template ${s.dim('(full|quick|code-review, or custom [Team])')}`,
     `    ${s.brand('-h')}, ${s.brand('--help')}         Show this help`,
     '',
     `  ${s.bold('EXAMPLES')}`,

package/skills/jtb/scripts/lib/jira-client.mjs

@@ -12,19 +12,44 @@ function toText(value) {
   return adfToText(value);
 }
 
+/**
+ * Returns the ISO date string when the ticket entered its current status,
+ * derived from Jira's changelog history. Walks backwards (most recent first)
+ * to find the last transition whose `toString` matches `currentStatus`.
+ * Returns null when changelog is absent or has no matching transition.
+ */
+export function parseStatusChangedAt(changelog, currentStatus) {
+  if (!changelog?.histories?.length || !currentStatus) return null;
+  for (let i = changelog.histories.length - 1; i >= 0; i--) {
+    const history = changelog.histories[i];
+    const item = history.items?.find(it => it.field === 'status' && it.toString === currentStatus);
+    if (item) return history.created ?? null;
+  }
+  return null;
+}
+
 export function normalizeTicket(raw) {
   const f = raw.fields;
+  const currentStatus = f.status?.name ?? null;
+  // statusChangedAt: when the ticket entered its current status.
+  // Only populated when raw.changelog is present (i.e. ?expand=changelog was requested).
+  // Falls back to ticket.created when changelog is present but no matching transition exists
+  // (ticket was created in its current status and never transitioned away then back).
+  const statusChangedAt = raw.changelog !== undefined
+    ? (parseStatusChangedAt(raw.changelog, currentStatus) ?? (f.created ?? null))
+    : null;
   return {
     key: raw.key,
     summary: f.summary,
     type: f.issuetype?.name ?? null,
-    status: f.status?.name ?? null,
+    status: currentStatus,
     priority: f.priority?.name ?? null,
     assignee: f.assignee?.displayName ?? null,
     reporter: f.reporter?.displayName ?? null,
     description: toText(f.description),
     created: f.created ?? null,
     updated: f.updated ?? null,
+    statusChangedAt,
     labels: f.labels ?? [],
     components: (f.components ?? []).map(c => c.name),
     comments: (f.comment?.comments ?? []).map(c => ({
@@ -110,12 +135,13 @@ export async function fetchStatuses(opts = {}) {
 }
 
 export async function searchTickets(jql, opts = {}) {
-  const { env = process.env, fetcher = globalThis.fetch, maxResults = 50, apiVersion = 2, timeoutMs = 10_000 } = opts;
+  const { env = process.env, fetcher = globalThis.fetch, maxResults = 50, apiVersion = 2, timeoutMs = 10_000, expandChangelog = false } = opts;
   const baseUrl = env.JIRA_BASE_URL.replace(/\/$/, '');
   const headers = { ...buildAuthHeader(env), 'Content-Type': 'application/json' };
 
-  const fields = 'summary,status,assignee,priority,issuetype,comment,updated,statuscategorychangedate';
+  const fields = 'summary,status,assignee,priority,issuetype,comment,updated,statuscategorychangedate,created';
   const params = new URLSearchParams({ jql, fields, maxResults: String(maxResults) });
+  if (expandChangelog) params.set('expand', 'changelog');
   const endpoint = apiVersion >= 3 ? `/rest/api/3/search/jql` : `/rest/api/2/search`;
   const url = `${baseUrl}${endpoint}?${params}`;
   const fetchOpts = { headers };
@@ -153,11 +179,12 @@ export async function fetchRemoteLinks(ticketKey, opts = {}) {
 }
 
 export async function fetchTicket(ticketKey, opts = {}) {
-  const { env = process.env, fetcher = globalThis.fetch, depth = 1, apiVersion = 2, timeoutMs = 10_000, _visited = new Set(), _currentDepth = 0 } = opts;
+  const { env = process.env, fetcher = globalThis.fetch, depth = 1, apiVersion = 2, timeoutMs = 10_000, expandChangelog = false, _visited = new Set(), _currentDepth = 0 } = opts;
   const baseUrl = env.JIRA_BASE_URL.replace(/\/$/, '');
   const headers = { ...buildAuthHeader(env), 'Content-Type': 'application/json' };
 
-  const url = `${baseUrl}/rest/api/${apiVersion}/issue/${encodeURIComponent(ticketKey)}`;
+  const expand = expandChangelog ? '?expand=changelog' : '';
+  const url = `${baseUrl}/rest/api/${apiVersion}/issue/${encodeURIComponent(ticketKey)}${expand}`;
   const fetchOpts = { headers };
   if (timeoutMs) fetchOpts.signal = AbortSignal.timeout(timeoutMs);
   const response = await fetcher(url, fetchOpts);
@@ -184,7 +211,8 @@ export async function fetchTicket(ticketKey, opts = {}) {
     linkedKeys.forEach(k => _visited.add(k));
 
     ticket.linkedTicketDetails = await Promise.all(
-      linkedKeys.map(k => fetchTicket(k, { ...opts, _visited, _currentDepth: _currentDepth + 1 }))
+      // Linked tickets are context only — never scored, so skip changelog expansion for them.
+      linkedKeys.map(k => fetchTicket(k, { ...opts, expandChangelog: false, _visited, _currentDepth: _currentDepth + 1 }))
     );
   }
 

package/skills/jtb/scripts/lib/profile-resolver.mjs

@@ -232,6 +232,7 @@ export function resolveConnection(ticketKey, opts = {}) {
       triageStatuses: profile.triageStatuses || null,
       ticketPrefixes: profile.ticketPrefixes || null,
       attentionRules: profile.attentionRules ?? null,
+      staleRule: profile.staleRule ?? null,
       source: 'profile',
       profileName: profile.name,
     };

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

@@ -28,10 +28,12 @@ export function styleTriageSummary(scoredTickets, opts = {}) {
 
   const needsResponse = actionable.filter(t => t.urgency === 'needs-response');
   const aging = actionable.filter(t => t.urgency === 'aging');
+  const stale = actionable.filter(t => t.urgency === 'stale');
 
   const parts = [];
   if (needsResponse.length > 0) parts.push(`${needsResponse.length} need response`);
   if (aging.length > 0) parts.push(`${aging.length} aging`);
+  if (stale.length > 0) parts.push(`${stale.length} stale`);
 
   const sections = [];
   sections.push(s.bold(`${actionable.length} tickets need attention`) + ' ' + s.dim(`(${parts.join(', ')})`) );
@@ -40,6 +42,7 @@ export function styleTriageSummary(scoredTickets, opts = {}) {
   const legendParts = [];
   if (needsResponse.length > 0) legendParts.push(`${s.red('●')} needs response`);
   if (aging.length > 0) legendParts.push(`${s.yellow('●')} aging`);
+  if (stale.length > 0) legendParts.push(`${s.cyan('●')} stale`);
   let legend = legendParts.join('    ');
   if (browseUrl) legend += `\n${s.dim('Open:')} ${browseUrl}${s.dim('<key>')}`;
   sections.push(legend);
@@ -70,7 +73,21 @@ export function styleTriageSummary(scoredTickets, opts = {}) {
       return [String(agingOffset + i + 1), ticketCell(t.ticketKey, s.yellow), truncate(t.summary, 45), t.status, `${days}d`];
     });
     const table = formatTable(
-      ['#', 'Ticket', 'Title', 'Status', 'Stale'],
+      ['#', 'Ticket', 'Title', 'Status', 'Idle'],
+      tableRows,
+      { maxWidths: { 2: 45 } },
+    );
+    sections.push(table);
+  }
+
+  if (stale.length > 0) {
+    const staleOffset = needsResponse.length + aging.length;
+    const tableRows = stale.map((t, i) => {
+      const days = t.daysInCurrentStatus ?? '?';
+      return [String(staleOffset + i + 1), ticketCell(t.ticketKey, s.cyan), truncate(t.summary, 45), t.status, `${days}d`];
+    });
+    const table = formatTable(
+      ['#', 'Ticket', 'Title', 'Status', 'Stuck'],
       tableRows,
       { maxWidths: { 2: 45 } },
     );
@@ -81,7 +98,8 @@ export function styleTriageSummary(scoredTickets, opts = {}) {
 }
 
 export function styleBrief(ticket, codeRefs = null, opts = {}) {
-  const { styled = true } = opts;
+  const { styled = true, templateSections = null } = opts;
+  const ts = templateSections;
   const s = createStyler({ forceColor: styled, noColor: !styled });
 
   const sections = [];
@@ -89,7 +107,7 @@ export function styleBrief(ticket, codeRefs = null, opts = {}) {
   // Header: ticket key + summary
   sections.push(s.bold(s.brand(`${ticket.key}: ${ticket.summary}`)));
 
-  // Metadata line
+  // Metadata line (always included)
   const meta = [
     `${s.dim('Type:')} ${ticket.type}`,
     `${s.dim('Status:')} ${statusColor(s, ticket.status)}`,
@@ -101,13 +119,19 @@ export function styleBrief(ticket, codeRefs = null, opts = {}) {
   sections.push(meta.join(s.dim('  ·  ')));
 
   // Description
-  if (ticket.description) {
+  if (ticket.description && (ts === null || ts.description !== false)) {
     sections.push(`${s.bold(s.brand('Description'))}\n${s.dim('─'.repeat(divWidth()))}\n${stripCr(ticket.description)}`);
   }
 
   // Comments
-  if (ticket.comments?.length > 0) {
-    const commentLines = ticket.comments.map(c => {
+  const commentsEnabled = ts === null || ts.comments?.enabled !== false;
+  const rawMax          = ts?.comments?.max;
+  const commentsMax     = (typeof rawMax === 'number' && rawMax >= 0) ? rawMax : Infinity;
+  const visibleComments = commentsEnabled && ticket.comments?.length > 0
+    ? ticket.comments.slice(0, commentsMax === Infinity ? ticket.comments.length : commentsMax)
+    : [];
+  if (visibleComments.length > 0) {
+    const commentLines = visibleComments.map(c => {
       const date = c.created ? c.created.split('T')[0] : 'unknown';
       return `${s.brand(c.author)} ${s.dim(`(${date})`)}\n${stripCr(c.body)}`;
     });
@@ -115,7 +139,7 @@ export function styleBrief(ticket, codeRefs = null, opts = {}) {
   }
 
   // Linked tickets
-  if (ticket.linkedTicketDetails?.length > 0) {
+  if (ticket.linkedTicketDetails?.length > 0 && (ts === null || ts.linked !== false)) {
     const linkedSections = ticket.linkedTicketDetails.map(lt => {
       const parts = [`${s.brand(lt.key)}: ${lt.summary}`, `${s.dim('Type:')} ${lt.type} | ${s.dim('Status:')} ${statusColor(s, lt.status)}`];
       if (lt.description) parts.push(stripCr(lt.description));
@@ -132,7 +156,7 @@ export function styleBrief(ticket, codeRefs = null, opts = {}) {
   }
 
   // Confluence pages
-  if (ticket.confluencePages?.length > 0) {
+  if (ticket.confluencePages?.length > 0 && (ts === null || ts.confluence !== false)) {
     const pageLines = ticket.confluencePages.map(p => {
       const parts = [s.brand(p.title ?? p.url)];
       if (p.text) parts.push(p.text);
@@ -142,7 +166,7 @@ export function styleBrief(ticket, codeRefs = null, opts = {}) {
   }
 
   // Code references
-  if (codeRefs) {
+  if (codeRefs && (ts === null || ts.code_refs !== false)) {
     const categories = [
       ['File Paths', codeRefs.filePaths],
       ['Methods', codeRefs.methods],
@@ -160,7 +184,7 @@ export function styleBrief(ticket, codeRefs = null, opts = {}) {
     }
   }
 
-  if (ticket.attachments?.length > 0) {
+  if (ticket.attachments?.length > 0 && (ts === null || ts.attachments !== false)) {
     const lines = ticket.attachments.map(a => {
       const r = (ticket.localAttachments ?? []).find(x => x.filename === a.filename);
       const sz = formatSize(a.size);

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

@@ -33,6 +33,8 @@ export function serverToCliProfile(serverProfile) {
     ...(p.ticket_prefixes?.length  ? { ticketPrefixes: p.ticket_prefixes }    : {}),
     ...(p.project_paths?.length    ? { projectPaths: p.project_paths }        : {}),
     ...(p.triage_statuses?.length  ? { triageStatuses: p.triage_statuses }    : {}),
+    ...(p.stale_rule               ? { staleRule: p.stale_rule }              : {}),
+    ...(p.known_statuses?.length   ? { knownStatuses: p.known_statuses, statusesCachedAt: p.statuses_cached_at ?? null } : {}),
   };
   return { name: p.name, profileData };
 }

package/skills/jtb/scripts/lib/template-resolver.mjs

@@ -0,0 +1,124 @@
+/**
+ * Resolves a brief template by slug.
+ * System templates (full / quick / code-review) are hardcoded and work offline.
+ * Custom team templates require a CLI token and are fetched from /v1/templates.
+ */
+
+import { getApiBase } from './sync.mjs';
+
+export const SYSTEM_TEMPLATES = [
+  {
+    slug: 'full',
+    name: 'Full Brief',
+    is_system: true,
+    sections: {
+      meta:        true,
+      description: true,
+      comments:    { enabled: true, max: 10 },
+      linked:      true,
+      code_refs:   true,
+      confluence:  true,
+      attachments: true,
+    },
+  },
+  {
+    slug: 'quick',
+    name: 'Quick Scan',
+    is_system: true,
+    sections: {
+      meta:        true,
+      description: false,
+      comments:    { enabled: true, max: 2 },
+      linked:      false,
+      code_refs:   false,
+      confluence:  false,
+      attachments: false,
+    },
+  },
+  {
+    slug: 'code-review',
+    name: 'Code Review',
+    is_system: true,
+    sections: {
+      meta:        true,
+      description: true,
+      comments:    { enabled: false, max: 0 },
+      linked:      true,
+      code_refs:   true,
+      confluence:  false,
+      attachments: false,
+    },
+  },
+];
+
+const SYSTEM_SLUGS = new Set(SYSTEM_TEMPLATES.map(t => t.slug));
+
+/**
+ * Resolve a template by slug.
+ *
+ * @param {string}  slug
+ * @param {object}  opts
+ * @param {string|null} opts.token    CLI token (null = offline)
+ * @param {Function}    [opts.fetcher] globalThis.fetch override (for testing)
+ * @returns {Promise<object>} template with { slug, sections, is_system, ... }
+ * @throws  {Error} if slug is unknown and cannot be resolved
+ */
+export async function resolveTemplate(slug, { token, fetcher = globalThis.fetch } = {}) {
+  if (!slug || !/^[a-z0-9_-]{1,64}$/.test(slug)) {
+    throw new Error(`Invalid template slug "${slug}". Use lowercase letters, numbers, hyphens, or underscores (max 64 chars).`);
+  }
+
+  const systemMatch = SYSTEM_TEMPLATES.find(t => t.slug === slug);
+
+  if (!token) {
+    if (systemMatch) {
+      process.stderr.write(
+        `  ○ Template "${slug}" resolved from local system definitions (no login required).\n`,
+      );
+      return systemMatch;
+    }
+    throw new Error(
+      `Template "${slug}" not found. Custom templates require \`ticketlens login\`.`,
+    );
+  }
+
+  // Try the API first.
+  let apiTemplates = null;
+  try {
+    const res = await fetcher(`${getApiBase()}/v1/templates`, {
+      headers:  { Authorization: `Bearer ${token}`, Accept: 'application/json' },
+      signal:   AbortSignal.timeout(10_000),
+    });
+    if (res.ok) {
+      apiTemplates = await res.json();
+    } else {
+      process.stderr.write(`  ⚠ Could not fetch templates (HTTP ${res.status}) — using local system definitions.\n`);
+    }
+  } catch {
+    process.stderr.write(`  ⚠ Could not reach templates API — using local system definitions.\n`);
+  }
+
+  if (apiTemplates) {
+    if (!Array.isArray(apiTemplates)) {
+      process.stderr.write(`  ⚠ Unexpected templates API response format — using local system definitions.\n`);
+    } else {
+      const found = apiTemplates.find(t => t.slug === slug);
+      if (found) return found;
+      const available = apiTemplates.map(t => t.slug).join(', ');
+      throw new Error(
+        `Template "${slug}" not found. Available templates: ${available}.\n` +
+        `  To create custom templates, go to Admin → Brief Templates in your TicketLens Console.`,
+      );
+    }
+  }
+
+  // API unreachable — fall back to system templates
+  if (systemMatch) {
+    process.stderr.write(`  ⚠ Using local system template "${slug}" (API unavailable).\n`);
+    return systemMatch;
+  }
+
+  throw new Error(
+    `Template "${slug}" not found and API is unreachable. Custom templates require \`ticketlens login\`.`,
+  );
+}

package/skills/jtb/scripts/lib/triage-history.mjs

@@ -10,7 +10,7 @@ import { join } from 'node:path';
 
 export const DEFAULT_CONFIG_DIR = join(homedir(), '.ticketlens');
 
-const URGENCY_ORDER = { 'needs-response': 0, 'aging': 1, 'clear': 2 };
+const URGENCY_ORDER = { 'needs-response': 0, 'aging': 1, 'stale': 2, 'clear': 3 };
 
 // ---------------------------------------------------------------------------
 // Internal helpers
@@ -126,8 +126,8 @@ export function diffSnapshots(today, yesterday) {
     const changes = [];
 
     // Urgency worsened
-    const todayOrder = URGENCY_ORDER[t.urgency] ?? 2;
-    const yesterdayOrder = URGENCY_ORDER[y.urgency] ?? 2;
+    const todayOrder = URGENCY_ORDER[t.urgency] ?? 3;
+    const yesterdayOrder = URGENCY_ORDER[y.urgency] ?? 3;
     if (todayOrder < yesterdayOrder) {
       changes.push(`${y.urgency} \u2192 ${t.urgency}`);
     }
@@ -284,7 +284,7 @@ function loadSnapshotForDate(dateStr, profile, configDir, fsModule) {
  *   medianResponseHours: number|null,
  *   clearRate: number|null,
  *   triageRunCount: number,
- *   currentUrgency: { needsResponse: number, aging: number, clear: number }|null,
+ *   currentUrgency: { needsResponse: number, aging: number, stale: number, clear: number }|null,
  *   windowDays: number,
  *   trendHours: number|null,
  * }}
@@ -354,6 +354,7 @@ export function computeResponseMetrics(profile, {
     ? {
         needsResponse: latest.tickets.filter(t => t.urgency === 'needs-response').length,
         aging:         latest.tickets.filter(t => t.urgency === 'aging').length,
+        stale:         latest.tickets.filter(t => t.urgency === 'stale').length,
         clear:         latest.tickets.filter(t => t.urgency === 'clear').length,
       }
     : null;