ticketlens 0.20.2 → 0.21.1

package/README.md

@@ -156,6 +156,7 @@ Three system templates ship out of the box:
 ticketlens triage                               # Scan assigned tickets — interactive
 ticketlens triage --profile=acme               # Explicit profile
 ticketlens triage --stale=3                    # Aging threshold: 3 days (default: 5)
+ticketlens triage --sort=priority              # Sort by priority first, then urgency (default: urgency)
 ticketlens triage --status="Code Review,QA"    # Override statuses to scan
 ticketlens triage --assignee="Jane Dev"        # Another dev's tickets [Team]
 ticketlens triage --sprint="Sprint 12"         # Filter by sprint [Team]
@@ -180,6 +181,8 @@ ticketlens triage --static                     # Static table, no interactive mo
 
 `--stale=N` controls both categories. Unanswered comments older than N days downgrade from "needs response" to "aging" automatically.
 
+`--sort=priority|urgency` controls display order for this run only. `priority` groups tickets by Jira priority (Highest → Lowest, unknown last) with urgency as the tiebreaker; `urgency` is today's default ordering. Set a permanent default by adding `"sortBy": "priority"` to a profile in `~/.ticketlens/profiles.json` — the flag overrides it for a single run, same relationship `--stale=N` has to `staleDays`. This is a personal, per-profile preference — it does not sync with the Console's own sort-order setting on the Account page, which only affects the Console queue view.
+
 Interactive mode: `↑/↓` navigate, `Enter` open in browser, `p` switch profile, `q/Esc` exit. Columns adapt to terminal width.
 
 Status mismatch auto-fix: if configured statuses don't match Jira's exact casing, triage shows a diff and offers to update your profile:
@@ -600,6 +603,7 @@ ticketlens triage                             # Scan assigned tickets — intera
 ticketlens triage --profile=acme             # Explicit profile
 ticketlens triage --stale=3                  # Needs-response window: 3 days (default: 5)
 ticketlens triage --stale=10                 # More lenient — only flag very stale tickets
+ticketlens triage --sort=priority            # Sort by priority first, then urgency (default: urgency)
 ticketlens triage --status="Code Review,QA Testing"  # Scan these statuses only
 ticketlens triage --static                   # Static table output (no interactive mode)
 ticketlens triage --plain                    # Plain markdown — pipe to LLM or file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.20.2",
+  "version": "0.21.1",
   "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.20.2 -->
+<!-- jtb-skill-version: 0.21.0 -->
 ---
 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.
@@ -28,6 +28,7 @@ Fetches a Jira ticket and produces a structured brief with code references, then
 /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 --sort=priority            # sort by priority first, then urgency (default: urgency)
 /jtb triage --status=CR,QA             # only check specific statuses
 /jtb triage --profile=acme             # explicit profile override
 /jtb triage --all                      # triage all configured profiles at once, merged (Pro)

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

@@ -74,7 +74,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
     args,
     ['--help', '-h', '--static', '--plain', '--styled', '--profile=', '--stale=', '--status=',
      '--assignee=', '--sprint=', '--export=', '--digest', '--push', '--share', '--all', '--save=',
-     '--project=', '--label=', '--priority='],
+     '--project=', '--label=', '--priority=', '--sort='],
     { hints: ['--depth=', '--no-attachments', '--no-cache'] }
   );
   if (validatedArgs === null) { process.exitCode = 1; return; }
@@ -86,6 +86,8 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
   const staleArg = args.find(a => a.startsWith('--stale='));
   const staleDays = staleArg ? parseInt(staleArg.split('=')[1], 10) : 5;
 
+  const sortArg = args.find(a => a.startsWith('--sort='));
+
   const statusArg   = args.find(a => a.startsWith('--status='));
   const assigneeArg = args.find(a => a.startsWith('--assignee='));
   const sprintArg   = args.find(a => a.startsWith('--sprint='));
@@ -426,7 +428,8 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
 
   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 sortBy = sortArg ? sortArg.split('=')[1] : conn.sortBy;
+  const sorted = sortByUrgency(actionable, { sortBy });
   const rawTicketMap = new Map(tickets.map(t => [t.key, t]));
 
   // Always save a daily snapshot for history tracking (non-fatal)

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

@@ -207,8 +207,24 @@ export function scoreAttention(ticket, currentUser, opts = {}) {
 
 export const URGENCY_ORDER = { 'needs-response': 0, 'aging': 1, 'stale': 2, 'clear': 3 };
 
-export function sortByUrgency(scores) {
+// Standard Jira priority names, case-insensitive. Synonyms for the top tier (some
+// instances/plugins use "Urgent" or "Blocker" instead of "Highest") share rank 0.
+// Anything not in this map (custom priority scheme, or missing) sorts last.
+export const PRIORITY_ORDER = { highest: 0, urgent: 0, blocker: 0, high: 1, medium: 2, low: 3, lowest: 4 };
+
+function priorityRank(priority) {
+  if (!priority) return Infinity;
+  const rank = PRIORITY_ORDER[priority.toLowerCase()];
+  return rank === undefined ? Infinity : rank;
+}
+
+export function sortByUrgency(scores, opts = {}) {
+  const { sortBy } = opts;
   return [...scores].sort((a, b) => {
+    if (sortBy === 'priority') {
+      const priorityDiff = priorityRank(a.priority) - priorityRank(b.priority);
+      if (priorityDiff !== 0) return priorityDiff;
+    }
     const orderDiff = URGENCY_ORDER[a.urgency] - URGENCY_ORDER[b.urgency];
     if (orderDiff !== 0) return orderDiff;
     // Within same urgency, sort by most recent activity (lastComment date or ticket updated)

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

@@ -25,13 +25,37 @@ export function readCliToken(configDir = DEFAULT_CONFIG_DIR) {
   }
 }
 
-export function saveCliToken(token, configDir = DEFAULT_CONFIG_DIR) {
+// Server-asserted tier (personal or team-seat) synced alongside the token on
+// every login/sync — separate from the signed, offline license.json file.
+// Lets team-invited members get Pro-equivalent CLI access without a personal
+// TL- key, mirroring what the manager already pays for.
+export function readCliTokenTier(configDir = DEFAULT_CONFIG_DIR) {
+  const p = cliTokenPath(configDir);
+  if (!existsSync(p)) return null;
+  try {
+    const data = JSON.parse(readFileSync(p, 'utf8'));
+    return typeof data.tier === 'string' ? data.tier : null;
+  } catch {
+    return null;
+  }
+}
+
+export function saveCliToken(token, configDir = DEFAULT_CONFIG_DIR, tier = undefined) {
   mkdirSync(configDir, { recursive: true });
   const p = cliTokenPath(configDir);
-  writeFileSync(p, JSON.stringify({ token }, null, 2) + '\n', { encoding: 'utf8', mode: 0o600 });
+  const payload = tier === undefined ? { token } : { token, tier };
+  writeFileSync(p, JSON.stringify(payload, null, 2) + '\n', { encoding: 'utf8', mode: 0o600 });
   chmodSync(p, 0o600);
 }
 
+// Updates just the cached tier without touching the token — used by `tl sync`
+// to keep entitlement fresh between logins.
+export function saveCliTokenTier(tier, configDir = DEFAULT_CONFIG_DIR) {
+  const token = readCliToken(configDir);
+  if (!token) return;
+  saveCliToken(token, configDir, tier);
+}
+
 export function deleteCliToken(configDir = DEFAULT_CONFIG_DIR) {
   const p = cliTokenPath(configDir);
   if (existsSync(p)) {

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

@@ -84,6 +84,7 @@ export function printHelp({ stream = process.stdout } = {}) {
     // "--assignee=NAME"=15, "--sprint=NAME"=13, "--static"=8, "--plain"=7  →  target=19
     `    ${s.brand('--profile')}=${s.dim('NAME')}     Use a specific Jira profile`,
     `    ${s.brand('--stale')}=${s.dim('N')}          Aging threshold in days ${s.dim('(default: 5)')}`,
+    `    ${s.brand('--sort')}=${s.dim('ORDER')}       Sort order ${s.dim('(priority|urgency, default: urgency)')}`,
     `    ${s.brand('--status')}=${s.dim('X,Y')}       Override statuses to scan`,
     `    ${s.brand('--assignee')}=${s.dim('NAME')}    Triage another dev's tickets  ${s.dim('[Team]')}`,
     `    ${s.brand('--sprint')}=${s.dim('NAME')}      Filter by sprint name  ${s.dim('[Team]')}`,
@@ -107,6 +108,7 @@ export function printHelp({ stream = process.stdout } = {}) {
     `    ${s.dim('$')} ticketlens get PROJ-123 --depth=0 --profile=myteam`,
     `    ${s.dim('$')} ticketlens triage`,
     `    ${s.dim('$')} ticketlens triage --profile=acme --stale=3`,
+    `    ${s.dim('$')} ticketlens triage --sort=priority`,
     `    ${s.dim('$')} ticketlens triage --static`,
     '',
     `  ${s.bold('CONFIGURATION')}`,
@@ -625,6 +627,7 @@ export function printTriageHelp({ stream = process.stdout } = {}) {
     // "--assignee=NAME"=15, "--sprint=NAME"=13, "--static"=8, "--plain"=7, "-h, --help"=10  →  target=19
     `    ${s.brand('--profile')}=${s.dim('NAME')}     Use a specific Jira profile`,
     `    ${s.brand('--stale')}=${s.dim('N')}          Aging threshold in days ${s.dim('(default: 5)')}`,
+    `    ${s.brand('--sort')}=${s.dim('ORDER')}       Sort order ${s.dim('(priority|urgency, default: urgency)')}`,
     `    ${s.brand('--status')}=${s.dim('X,Y')}       Override statuses to scan`,
     `    ${s.brand('--assignee')}=${s.dim('NAME')}    Triage another dev's tickets  ${s.dim('[Team]')}`,
     `    ${s.brand('--sprint')}=${s.dim('NAME')}      Filter by sprint name  ${s.dim('[Team]')}`,
@@ -645,6 +648,7 @@ export function printTriageHelp({ stream = process.stdout } = {}) {
     '',
     `    ${s.dim('$')} ticketlens triage`,
     `    ${s.dim('$')} ticketlens triage --profile=acme`,
+    `    ${s.dim('$')} ticketlens triage --sort=priority`,
     `    ${s.dim('$')} ticketlens triage --stale=3 --status="Code Review,QA Testing"`,
     `    ${s.dim('$')} ticketlens triage --assignee="Jane Dev" --sprint="Sprint 12"`,
     `    ${s.dim('$')} ticketlens triage --project=MYPROJ --priority=High`,

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

@@ -5,6 +5,7 @@ import crypto from 'node:crypto';
 import { DEFAULT_CONFIG_DIR } from './config.mjs';
 import { createStyler } from './ansi.mjs';
 import { siteBase } from './api-utils.mjs';
+import { readCliTokenTier } from './cli-auth.mjs';
 
 // Mixed into the HMAC key so that knowing the license key alone is not sufficient
 // to forge a valid signature — an attacker also needs this constant from the source.
@@ -100,6 +101,15 @@ export function isLicensed(tier, configDir = DEFAULT_CONFIG_DIR) {
   if (required === 0) return true;
   if (process.env.TICKETLENS_SKIP_LICENSE === 'true') return true;
 
+  if (checkOwnLicense(required, configDir)) return true;
+
+  // Team-seat entitlement, server-asserted and synced via login/`tl sync` —
+  // covers invited team members who never activated a personal TL- key.
+  const syncedTier = LICENSE_TIERS[readCliTokenTier(configDir)] ?? 0;
+  return syncedTier >= required;
+}
+
+function checkOwnLicense(required, configDir) {
   const license = readLicense(configDir);
   if (!license) return false;
 

package/skills/jtb/scripts/lib/login-flow.mjs

@@ -83,7 +83,12 @@ export async function runLogin({
     return;
   }
 
-  saveCliTokenFn(token);
+  let tier;
+  try {
+    tier = (await res.json())?.tier;
+  } catch { /* tier is best-effort — token is still valid */ }
+
+  saveCliTokenFn(token, undefined, tier);
   stream.write(`\x1b[A\r\x1b[2K  ${s.green('✔')} Logged in.\n`);
 
   // Flow 1: pull team Jira config for Pro/Team members (silently skipped for Free)

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

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

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

@@ -5,7 +5,7 @@
  * Server wins on all non-credential fields (shape, prefixes, URLs, etc.).
  */
 
-import { readCliToken } from './cli-auth.mjs';
+import { readCliToken, saveCliTokenTier } from './cli-auth.mjs';
 import {
   loadProfiles,
   loadCredentials,
@@ -88,6 +88,8 @@ export async function syncProfiles({
   let json;
   try { json = await res.json(); } catch { return { error: 'invalid-json' }; }
 
+  if (typeof json?.tier === 'string') saveCliTokenTier(json.tier, configDir);
+
   const remoteProfiles = Array.isArray(json?.profiles) ? json.profiles : [];
   const localConfig  = loadProfiles(configDir) || { profiles: {} };
   const localCreds   = loadCredentials(configDir);