ticketlens 0.1.24 → 0.1.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "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

@@ -19,6 +19,7 @@ import { classifyError } from './lib/error-classifier.mjs';
 import { promptProfileSelect, promptProfileMismatch, promptSwitchProfile, promptMultipleMatches } from './lib/profile-picker.mjs';
 import { promptSelect } from './lib/select-prompt.mjs';
 import { printFetchHelp } from './lib/help.mjs';
+import { readTextAttachments } from './lib/handoff-assembler.mjs';
 import { handleUnknownFlags } from './lib/arg-validator.mjs';
 import { TICKET_KEY_PATTERN } from './lib/cli.mjs';
 import { downloadAttachments } from './lib/attachment-downloader.mjs';
@@ -104,11 +105,22 @@ function resolveAiProvider(args, credentials) {
   return credentials?.aiProvider ?? undefined;
 }
 
+/**
+ * Append text-readable attachment content to a brief for AI consumption only.
+ * The returned string is only sent to the AI — the displayed brief is unchanged.
+ */
+function augmentBriefForAi(brief, localAttachments) {
+  const textFiles = readTextAttachments(localAttachments);
+  if (textFiles.length === 0) return brief;
+  const sections = textFiles.map(({ filename, content }) => `=== Attachment: ${filename} ===\n${content}`);
+  return brief + `\n\n--- Attached Documents (${textFiles.length} text-readable) ---\n\n${sections.join('\n\n')}`;
+}
+
 /**
  * Apply --summarize to a brief string.
  * Returns the modified brief, or null if the caller should exit (license gate / consent refused).
  */
-async function applySummarize(brief, args, opts, configDir, conn, licensedFn, upgradeFn) {
+async function applySummarize(brief, args, opts, configDir, conn, licensedFn, upgradeFn, ticket) {
   if (!licensedFn('pro', configDir)) {
     upgradeFn('pro', '--summarize');
     process.exitCode = 1;
@@ -142,7 +154,8 @@ async function applySummarize(brief, args, opts, configDir, conn, licensedFn, up
     const credentials = opts.credentials ?? loadCredentials(configDir);
     const licenseKey = readLicense(configDir)?.key;
     const provider = opts.provider ?? resolveAiProvider(args, credentials);
-    const summary = await summarizerFn({ brief, mode, credentials, licenseKey, provider });
+    const aiInput = augmentBriefForAi(brief, ticket?.localAttachments);
+    const summary = await summarizerFn({ brief: aiInput, mode, credentials, licenseKey, provider });
     const divider = '─'.repeat(60);
     return brief + `\n\n${divider}\n─── AI Summary ${'─'.repeat(45)}\n${summary}\n${divider}\n`;
   } catch (err) {
@@ -955,7 +968,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
       if (args.includes('--check')) brief = applyCheck(brief, opts);
 
       if (args.includes('--summarize')) {
-        brief = await applySummarize(brief, args, opts, configDir, conn, licensedFn, upgradeFn);
+        brief = await applySummarize(brief, args, opts, configDir, conn, licensedFn, upgradeFn, cached.ticket);
         if (brief === null) return;
       }
 
@@ -1141,7 +1154,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
   if (args.includes('--check')) output = applyCheck(output, opts);
 
   if (args.includes('--summarize')) {
-    output = await applySummarize(output, args, opts, configDir, conn, licensedFn, upgradeFn);
+    output = await applySummarize(output, args, opts, configDir, conn, licensedFn, upgradeFn, ticket);
     if (output === null) return;
   }
 

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

@@ -1,13 +1,17 @@
-export const HANDOFF_PROMPT = `Build a structured handoff brief from this Jira ticket's comment thread.
+import { readFileSync } from 'node:fs';
+import { extname } from 'node:path';
+
+export const HANDOFF_PROMPT = `Build a structured handoff brief from this Jira ticket.
 The developer receiving this ticket has never seen it before — they need to get up to speed immediately.
+Use the description, comments, attached documents, and linked Confluence pages as context.
 
 Respond in exactly this format (use the exact headings):
 
 ### What was attempted
-[2–5 bullet points of concrete work already done, based on the comments. Be specific — mention code paths, methods, or files if the comments reference them.]
+[2–5 bullet points of concrete work already done. Be specific — mention code paths, methods, or files if referenced.]
 
 ### Current blockers
-[Bullet points of unresolved issues, errors, or dependencies blocking progress. Write "None identified" if the comments suggest the path is clear.]
+[Bullet points of unresolved issues, errors, or dependencies blocking progress. Write "None identified" if the path is clear.]
 
 ### Open questions
 [Bullet points of unanswered questions or decisions not yet made. Write "None identified" if everything is resolved.]
@@ -16,16 +20,46 @@ Respond in exactly this format (use the exact headings):
 [1–2 sentences on the best starting point for the incoming developer.]
 
 Rules:
-- Be specific and factual. Reference actual details from the comments.
-- Do not invent anything not present in the comments.
+- Be specific and factual. Reference actual details from the ticket content.
+- Do not invent anything not present in the provided context.
 - Keep each bullet under 20 words.
-- If there are no comments, state that clearly in each section.
+- If there are no comments, base your analysis on the description and attached documents.
 
 `;
 
+const TEXT_EXTENSIONS = new Set(['.txt', '.md', '.markdown', '.log', '.csv', '.json', '.xml', '.html', '.htm', '.rst', '.yaml', '.yml']);
+const MAX_CHARS_PER_FILE = 4000;
+const MAX_TOTAL_CHARS = 12000;
+
+/**
+ * Read text content from downloaded local attachments.
+ * Skips binary files (images, PDFs, Office docs). Caps content per file and in total.
+ * @param {Array} localAttachments - from ticket.localAttachments
+ * @returns {Array<{filename: string, content: string}>}
+ */
+export function readTextAttachments(localAttachments = []) {
+  let totalChars = 0;
+  const result = [];
+  for (const att of localAttachments) {
+    if (!att.localPath || att.skipReason === 'error') continue;
+    if (!TEXT_EXTENSIONS.has(extname(att.filename).toLowerCase())) continue;
+    try {
+      const raw = readFileSync(att.localPath, 'utf8');
+      const trimmed = raw.trim();
+      if (!trimmed) continue;
+      const remaining = MAX_TOTAL_CHARS - totalChars;
+      if (remaining <= 0) break;
+      const content = trimmed.slice(0, Math.min(MAX_CHARS_PER_FILE, remaining));
+      totalChars += content.length;
+      result.push({ filename: att.filename, content });
+    } catch { /* unreadable — skip */ }
+  }
+  return result;
+}
+
 /**
  * Build the text input sent to the AI for handoff analysis.
- * Contains the ticket header and full comment thread.
+ * Includes description, Confluence pages, text-readable attachments, and comment thread.
  *
  * @param {object} ticket - Normalized ticket object from jira-client.normalizeTicket
  * @returns {string}
@@ -40,6 +74,33 @@ export function buildHandoffInput(ticket) {
   if (ticket.reporter) lines.push(`Reporter: ${ticket.reporter}`);
   lines.push('');
 
+  if (ticket.description) {
+    lines.push('--- Description ---');
+    lines.push(ticket.description.replace(/\r/g, ''));
+    lines.push('');
+  }
+
+  if (ticket.confluencePages?.length > 0) {
+    lines.push(`--- Confluence Pages (${ticket.confluencePages.length}) ---`);
+    for (const p of ticket.confluencePages) {
+      lines.push('');
+      lines.push(`### ${p.title ?? p.url}`);
+      if (p.text) lines.push(p.text);
+    }
+    lines.push('');
+  }
+
+  const textAttachments = readTextAttachments(ticket.localAttachments);
+  if (textAttachments.length > 0) {
+    lines.push(`--- Attached Documents (${textAttachments.length} text-readable) ---`);
+    for (const { filename, content } of textAttachments) {
+      lines.push('');
+      lines.push(`=== ${filename} ===`);
+      lines.push(content);
+    }
+    lines.push('');
+  }
+
   const comments = ticket.comments ?? [];
   lines.push(`--- Comments (${comments.length} total) ---`);