ticketlens 0.1.12 → 0.1.14

package/README.md

@@ -42,7 +42,7 @@ Zero npm dependencies. Node.js built-ins only.
 
 ```bash
 npm install -g ticketlens
-ticketlens init          # Guided setup: Jira URL, auth type, connection test
+ticketlens init          # Guided setup: Jira, GitHub Issues, or Linear — connection test included
 ticketlens CNV1-2        # Fetch a ticket brief
 ticketlens triage        # Scan your assigned tickets
 ```
@@ -70,13 +70,13 @@ npx ticketlens CNV1-2
 
 | Command | Description |
 |---------|-------------|
-| `ticketlens init` | Guided wizard — Jira URL, auth, live connection test, optional settings |
+| `ticketlens init` | Guided wizard — Jira, GitHub Issues, or Linear — live connection test, optional settings |
 | `ticketlens switch` | Arrow-key panel to switch between configured profiles |
-| `ticketlens config [--profile=NAME]` | Edit any field on an existing profile |
+| `ticketlens config [--profile=NAME]` | Edit any field on an existing profile — always re-validates the connection |
 | `ticketlens profiles` | List all configured profiles (alias: `ticketlens ls`) |
 | `ticketlens delete <NAME>` | Remove a profile and its credentials (prompts `y/N` in TTY; use `--yes` in scripts/CI) |
 
-`init` collects: profile name, Jira URL (bare hostnames accepted — HTTPS probed first), auth type (auto-detected from URL), credentials (masked), and optional ticket prefixes, project paths, and triage statuses. On connection failure, a retry menu lets you fix credentials, URL, or skip — all inputs pre-populated.
+`init` collects: profile name, tracker type (Jira / GitHub Issues / Linear), URL or workspace, credentials (masked), and optional ticket prefixes, project paths, and triage statuses. On connection failure, a retry menu lets you fix credentials, URL, or skip — all inputs pre-populated. `config` is tracker-aware and always re-validates the connection after edits.
 
 `config` uses merge semantics: new ticket prefixes and triage statuses are added to existing lists, never replaced. Partial matching resolves `QA` to `QA Testing` if that's the status in your Jira.
 
@@ -455,11 +455,13 @@ npm test
 See [ROADMAP.md](ROADMAP.md) for the full plan.
 
 Recently shipped:
-- Console queue dashboard — live at `/console/queue` for Team tier; push snapshots with `ticketlens triage --push`
+- **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:
-- Slack/Teams alerts for triage changes (Team)
-- GitHub Issues and Linear support
+- Confluence/wiki page fetching (F45)
+- "TicketLens for PRs" — PR context assembly with linked tickets and compliance (F46)
 
 ---
 

package/package.json

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

@@ -28,6 +28,8 @@ import { createStyler } from './lib/ansi.mjs';
 import { isLicensed, showUpgradePrompt, readLicense } from './lib/license.mjs';
 import { detectVcs } from './lib/vcs-detector.mjs';
 import { runComplianceCheck } from './lib/compliance-checker.mjs';
+import { fetchRemoteLinks, buildAuthHeader } from './lib/jira-client.mjs';
+import { fetchConfluencePage } from './lib/confluence-client.mjs';
 
 /**
  * Get the local diff using spawn with explicit arg arrays (never shell interpolation).
@@ -566,6 +568,29 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
   session.connected();
   process.stderr.write('\n');
 
+  // ── Confluence page fetching ───────────────────────────────────────────────
+  // Fetch pages referenced via Jira Remote Links (Confluence-only, non-blocking).
+  // Runs before cache write so cached briefs include the pages.
+  ticket.confluencePages = [];
+  if (adapter.type === 'jira' && !args.includes('--no-attachments')) {
+    try {
+      const jiraEnv = buildJiraEnv(conn);
+      const authHeader = buildAuthHeader(jiraEnv);
+      const apiVersion = conn.auth === 'cloud' ? 3 : 2;
+      const jiraOrigin = new URL(jiraEnv.JIRA_BASE_URL).origin;
+      const links = await fetchRemoteLinks(ticketKey, { env: jiraEnv, fetcher, apiVersion });
+      const MAX_CONFLUENCE_PAGES = 10;
+      const safeLinks = links
+        .filter(l => { try { return new URL(l.url).origin === jiraOrigin; } catch { return false; } })
+        .slice(0, MAX_CONFLUENCE_PAGES);
+      if (safeLinks.length > 0) {
+        const pages = await Promise.all(safeLinks.map(l => fetchConfluencePage(l.url, authHeader, { fetcher })));
+        ticket.confluencePages = pages.filter(Boolean);
+      }
+    } catch { /* non-fatal — a broken remote links endpoint must not fail the brief */ }
+  }
+  // ──────────────────────────────────────────────────────────────────────────
+
   // Save to brief cache for future requests
   if (!noCache) {
     writeBriefCache(ticketKey, conn.profileName, depth, ticket, configDir);

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

@@ -43,6 +43,15 @@ export function assembleBrief(ticket, codeRefs = null) {
     sections.push(`## Linked Tickets\n\n${linkedSections.join('\n\n---\n\n')}`);
   }
 
+  if (ticket.confluencePages?.length > 0) {
+    const pageLines = ticket.confluencePages.map(p => {
+      const parts = [`### ${p.title ?? p.url}`];
+      if (p.text) parts.push(p.text);
+      return parts.join('\n\n');
+    });
+    sections.push(`## Confluence Pages\n\n${pageLines.join('\n\n---\n\n')}`);
+  }
+
   if (codeRefs) {
     const categories = [
       ['File Paths', codeRefs.filePaths],

package/skills/jtb/scripts/lib/config-wizard.mjs

@@ -152,22 +152,14 @@ export async function run({ configDir = DEFAULT_CONFIG_DIR, profileName } = {})
   const tokenHint = existingToken ? s.dim('  [keep existing]') : '';
   const tokenLabel = s.dim(getTokenLabel(trackerType, auth)) + tokenHint + s.dim(':');
   token = await promptSecret(tokenLabel, { stream, existingValue: existingToken });
-  const tokenChanged = token !== existingToken;
 
-  // ── Connection test (only when something changed) ─────────────────────────
-  const connectionChanged = url !== profile.baseUrl
-    || auth !== profile.auth
-    || email !== (profile.email || '')
-    || tokenChanged;
+  // ── Connection test (always) ──────────────────────────────────────────────
+  let connected = false;
+  let startFrom = 'test';
 
-  let connected = !connectionChanged;
-
-  if (connectionChanged) {
-    let startFrom = 'test';
-
-    setupLoop: while (true) {
-      // Re-prompt URL + auth (on retry)
-      if (startFrom === 'url') {
+  setupLoop: while (true) {
+    // Re-prompt URL + auth (on retry with 'url' option)
+    if (startFrom === 'url') {
         stream.write('\n');
         const reTyped = await promptText(
           s.dim(urlLabel) + s.dim(`  [current: ${url}]:`),
@@ -249,11 +241,10 @@ export async function run({ configDir = DEFAULT_CONFIG_DIR, profileName } = {})
       startFrom = RETRY_OPTIONS[retryIdx].value;
     }
 
-    if (!connected) {
-      stream.write(`\n  ${s.yellow('○')} Connection changes discarded. ${s.dim('Run')} ${s.cyan('ticketlens config')} ${s.dim('again to retry.')}\n\n`);
-      process.exitCode = 1;
-      return;
-    }
+  if (!connected) {
+    stream.write(`\n  ${s.yellow('○')} Connection changes discarded. ${s.dim('Run')} ${s.cyan('ticketlens config')} ${s.dim('again to retry.')}\n\n`);
+    process.exitCode = 1;
+    return;
   }
 
   // ── Optional settings ──────────────────────────────────────────────────────

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

@@ -0,0 +1,101 @@
+/**
+ * Confluence REST API client.
+ * Fetches page content for Confluence pages referenced in Jira remote links.
+ */
+
+/**
+ * Extracts the numeric page ID from a Confluence page URL.
+ * Supports Cloud (/wiki/spaces/{key}/pages/{id}) and Server (?pageId={id}).
+ * Returns null when the ID cannot be determined.
+ * @param {string} url
+ * @returns {string|null}
+ */
+export function extractConfluencePageId(url) {
+  if (!url) return null;
+
+  const qpMatch = url.match(/[?&]pageId=(\d+)/);
+  if (qpMatch) return qpMatch[1];
+
+  const pathMatch = url.match(/\/wiki\/spaces\/[^/]+\/pages\/(\d+)(?:\/|$)/);
+  if (pathMatch) return pathMatch[1];
+
+  return null;
+}
+
+/**
+ * Converts a Confluence view-body HTML string to plain text.
+ * Uses simple regex-based transformation — no external dependencies.
+ * @param {string} html
+ * @returns {string}
+ */
+export function htmlToText(html) {
+  if (!html) return '';
+  return html
+    .replace(/<\/?(p|div|h[1-6]|li|tr|td|th|blockquote|pre)[^>]*>/gi, '\n')
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<[^>]+>/g, '')
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&#160;|&nbsp;/g, ' ')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+}
+
+/**
+ * Determines the Confluence REST API base path from a page URL.
+ * Cloud: {origin}/wiki/rest/api/content/{pageId}
+ * Server/DC without /wiki/: {origin}{/prefix}/rest/api/content/{pageId}
+ * @param {string} pageUrl
+ * @param {string} pageId
+ * @returns {string}
+ */
+function buildApiUrl(pageUrl, pageId) {
+  try {
+    const parsed = new URL(pageUrl);
+    if (parsed.pathname.includes('/wiki/')) {
+      return `${parsed.origin}/wiki/rest/api/content/${pageId}?expand=body.view`;
+    }
+    const confluencePrefix = parsed.pathname.match(/^(\/confluence)\//);
+    const prefix = confluencePrefix ? confluencePrefix[1] : '';
+    return `${parsed.origin}${prefix}/rest/api/content/${pageId}?expand=body.view`;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Fetches a Confluence page and returns its plain-text body.
+ * Returns null on any error (non-OK response, network failure, unparseable URL).
+ * @param {string} url - The Confluence page URL from the Jira remote link
+ * @param {object} authHeader - Authorization header object, e.g. { Authorization: 'Basic ...' }
+ * @param {{ fetcher?: Function, timeoutMs?: number }} [opts]
+ * @returns {Promise<{url: string, title: string, text: string}|null>}
+ */
+export async function fetchConfluencePage(url, authHeader, opts = {}) {
+  const { fetcher = globalThis.fetch, timeoutMs = 10_000 } = opts;
+
+  const pageId = extractConfluencePageId(url);
+  if (!pageId) return null;
+
+  const apiUrl = buildApiUrl(url, pageId);
+  if (!apiUrl) return null;
+
+  const fetchOpts = { headers: { ...authHeader, 'Content-Type': 'application/json' } };
+  if (timeoutMs) fetchOpts.signal = AbortSignal.timeout(timeoutMs);
+
+  try {
+    const response = await fetcher(apiUrl, fetchOpts);
+    if (!response.ok) return null;
+
+    const data = await response.json();
+    return {
+      url,
+      title: data.title ?? null,
+      text: htmlToText(data.body?.view?.value ?? ''),
+    };
+  } catch {
+    return null;
+  }
+}

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

@@ -131,6 +131,23 @@ export async function searchTickets(jql, opts = {}) {
   return (raw.issues ?? []).map(normalizeTicket);
 }
 
+export async function fetchRemoteLinks(ticketKey, opts = {}) {
+  const { env = process.env, fetcher = globalThis.fetch, apiVersion = 2, timeoutMs = 10_000 } = opts;
+  const baseUrl = env.JIRA_BASE_URL.replace(/\/$/, '');
+  const url = `${baseUrl}/rest/api/${apiVersion}/issue/${encodeURIComponent(ticketKey)}/remotelink`;
+
+  const fetchOpts = { headers: { ...buildAuthHeader(env), 'Content-Type': 'application/json' } };
+  if (timeoutMs) fetchOpts.signal = AbortSignal.timeout(timeoutMs);
+
+  const response = await fetcher(url, fetchOpts);
+  if (!response.ok) return [];
+
+  const raw = await response.json();
+  return (raw ?? [])
+    .filter(link => link.application?.type === 'com.atlassian.confluence')
+    .map(link => ({ url: link.object.url, title: link.object.title ?? null }));
+}
+
 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 baseUrl = env.JIRA_BASE_URL.replace(/\/$/, '');

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

@@ -131,6 +131,16 @@ export function styleBrief(ticket, codeRefs = null, opts = {}) {
     sections.push(`${s.bold(s.brand('Linked Tickets'))}\n${s.dim('─'.repeat(divWidth()))}\n${linkedSections.join(`\n\n${s.dim('─'.repeat(halfDivWidth()))}\n`)}`);
   }
 
+  // Confluence pages
+  if (ticket.confluencePages?.length > 0) {
+    const pageLines = ticket.confluencePages.map(p => {
+      const parts = [s.brand(p.title ?? p.url)];
+      if (p.text) parts.push(p.text);
+      return parts.join('\n\n');
+    });
+    sections.push(`${s.bold(s.brand('Confluence Pages'))}\n${s.dim('─'.repeat(divWidth()))}\n${pageLines.join(`\n\n${s.dim('─'.repeat(halfDivWidth()))}\n`)}`);
+  }
+
   // Code references
   if (codeRefs) {
     const categories = [