ticketlens 0.9.0 → 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.9.0",
+  "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.9.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

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/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);

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/styled-assembler.mjs

@@ -98,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 = [];
@@ -106,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)}`,
@@ -118,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)}`;
     });
@@ -132,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));
@@ -149,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);
@@ -159,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],
@@ -177,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/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\`.`,
+  );
+}