ticketlens 0.38.49 → 0.38.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.38.49",
+  "version": "0.38.50",
   "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.43.0 -->
+<!-- jtb-skill-version: 0.43.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.
@@ -424,6 +424,8 @@ ticketlens assign PROD-1234 --to=me                          # assign to yoursel
 ticketlens duplicates PROD-1234                               # find likely duplicates — read-only
 ticketlens link PROD-1234 PROD-5678                            # list valid link types — read-only
 ticketlens link PROD-1234 PROD-5678 --type="Duplicate" --confirm  # execute the link
+# Jira's list shows the real resulting sentence per type (e.g. "Blocks — PROD-1234 blocks PROD-5678")
+# so direction is never a guess — GitHub/Linear show just the type name (single relation, no ambiguity)
 ticketlens update PROD-1234 --title="Fix login on mobile"     # update title/description/labels/priority
 ticketlens update PROD-1234 --add-labels=urgent --remove-labels=stale
 ticketlens create --project=PROD --type="Task" --summary="Fix login on mobile"  # create a new ticket

package/skills/jtb/scripts/lib/adapters/jira-adapter.mjs

@@ -109,12 +109,16 @@ export function createJiraAdapter(conn, { fetcher = globalThis.fetch } = {}) {
     /**
      * Always fetched fresh — link type names are per-instance customizable
      * in Jira, same "never trust a stale list" principle as getTransitions.
-     * Returns just names (matches GitHub/Linear's plain-string shape) so
-     * runTicketLinkList can render any tracker's list uniformly.
+     * Returns name+inward+outward (backlog #31), not just the bare name:
+     * a bare name forces the caller to guess which end gets which phrase,
+     * which is exactly what produced 5 recurring "direction inverted"
+     * reports despite linkTo()'s own outward/inward mapping being correct
+     * and tested. GitHub/Linear keep returning plain strings — single
+     * relation type, no phrase ambiguity there.
      */
     async getLinkTypes(opts = {}) {
       const types = await getIssueLinkTypes({ ...base, ...opts });
-      return types.map(t => t.name);
+      return types.map(t => ({ name: t.name, inward: t.inward, outward: t.outward }));
     },
 
     /**

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 = 'https://api.ticketlens.app';
+export const DEFAULT_API_BASE = 'http://api.ticketlens.test';
 export const DEFAULT_SITE_BASE = 'https://ticketlens.app';
 
 // Matches localhost, 127.0.0.1, and any hostname ending in .test or .local,

package/skills/jtb/scripts/lib/ticket-command.mjs

@@ -577,7 +577,7 @@ export async function runTicketDuplicates(cmdArgs, {
  *
  * @param {string[]} cmdArgs - [sourceKey, targetKey]
  * @param {boolean} [cliHints] - see runTicketTransitionList's cliHints doc
- * @returns {Promise<{ ok: boolean, types?: string[] }>}
+ * @returns {Promise<{ ok: boolean, types?: (string|{name: string, inward: string, outward: string})[] }>}
  */
 export async function runTicketLinkList(cmdArgs, {
   configDir = DEFAULT_CONFIG_DIR,
@@ -607,7 +607,14 @@ export async function runTicketLinkList(cmdArgs, {
       return { ok: true, types: [] };
     }
     stream.write(`  Available link types for ${s.brand(s.bold(sourceKey))} → ${s.brand(s.bold(targetKey))} (${adapter.type}):\n\n`);
-    for (const t of types) stream.write(`    ${s.brand('●')} ${t}\n`);
+    for (const t of types) {
+      // Backlog #31: a bare type name (e.g. "Blocks") hides which end gets
+      // which phrase — show the real resulting sentence so the caller
+      // doesn't have to guess direction. GitHub/Linear still hand back
+      // plain strings (no inward/outward phrase pair to show).
+      const line = typeof t === 'string' ? t : `${t.name} — ${sourceKey} ${t.outward ?? t.name} ${targetKey}`;
+      stream.write(`    ${s.brand('●')} ${line}\n`);
+    }
     stream.write('\n');
     if (adapter.type === 'github') {
       stream.write(`  Note: GitHub has no generic link relationship — linking will CLOSE ${sourceKey} as a duplicate of ${targetKey}.\n`);