ticketlens 0.2.1 → 0.3.1

package/README.md

@@ -164,6 +164,27 @@ Bot comments (Jira Automation, Jenkins, GitHub Actions) are automatically ignore
 
 ---
 
+### Collisions
+
+```bash
+ticketlens collisions                         # Show branches that overlap with teammates [Team]
+ticketlens collisions --json                  # Machine-readable output
+ticketlens collisions --plain                 # Plain text, no ANSI colour
+```
+
+Requires a Team license and at least one teammate in your group. Compares your current git branch's changed files against your teammates' recent branches (within 7 days). Reports each overlap as a collision: your branch, their branch, the shared files, and linked ticket keys.
+
+```
+[1] feat/auth-refactor ↔ Jane Dev (feat/login-redesign)
+    Your tickets:  PROJ-101
+    Their tickets: PROJ-88
+    Shared files:  src/auth/LoginController.php, src/auth/guards.php
+```
+
+Branches are captured automatically when you run `ticketlens triage --push`. No extra step required.
+
+---
+
 ### Review
 
 ```bash
@@ -417,6 +438,11 @@ ticketlens triage --profile=acme --stale=3 --static          # Combine flags
 ticketlens triage --plain > my-tickets.md
 ticketlens triage --plain | llm "Which ticket is most urgent and why?"
 
+# ── Collisions ────────────────────────────────────────────────────────────────
+ticketlens collisions                         # Show branch collisions with teammates [Team]
+ticketlens collisions --json                  # Machine-readable JSON output
+ticketlens collisions --plain                 # Plain text, no ANSI colour
+
 # ── PR Review ─────────────────────────────────────────────────────────────────
 ticketlens review                             # Assemble PR review context from current branch
 ticketlens review --branch=main              # Compare against main (auto-detected by default)

package/bin/ticketlens.mjs

@@ -24,6 +24,7 @@ import {
   printProfilesHelp, printScheduleHelp,
   printInitHelp, printSwitchHelp, printConfigHelp,
   printReviewHelp, printStandupHelp, printUpdateSkillHelp,
+  printCollisionsHelp,
 } from '../skills/jtb/scripts/lib/help.mjs';
 import { createStyler } from '../skills/jtb/scripts/lib/ansi.mjs';
 import { readCliToken, saveCliToken, deleteCliToken } from '../skills/jtb/scripts/lib/cli-auth.mjs';
@@ -53,6 +54,7 @@ switch (command) {
     break;
 
   case 'collisions': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printCollisionsHelp(); break; }
     const { runCollisions } = await import('../skills/jtb/scripts/lib/run-collisions.mjs');
     runCollisions(cmdArgs).catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.2.1",
+  "version": "0.3.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.2.1 -->
+<!-- jtb-skill-version: 0.3.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.
@@ -27,6 +27,10 @@ Fetches a Jira ticket and produces a structured brief with code references, then
 /jtb triage --stale=3                  # custom aging threshold (days)
 /jtb triage --status=CR,QA             # only check specific statuses
 /jtb triage --profile=acme             # explicit profile override
+/jtb triage --push                     # push snapshot + git branches to Console (Team)
+/jtb triage --share                    # generate 24h share URL (Team)
+/jtb collisions                        # show branch collisions with teammates (Team)
+/jtb collisions --json                 # machine-readable output
 ```
 
 ## Prerequisites
@@ -63,6 +67,23 @@ Where `$EXTRA_ARGS` are any flags passed (e.g. `--stale=3 --status=QA --profile=
 
 ---
 
+### Collisions subcommand
+
+If the first argument is `collisions`:
+
+Run:
+```bash
+node ~/.agents/skills/jtb/scripts/lib/run-collisions.mjs $EXTRA_ARGS
+```
+
+Where `$EXTRA_ARGS` are any flags passed (e.g. `--json`, `--plain`).
+
+Requires a Team license and at least one teammate in the same group. Compares your current branch's changed files against teammates' recent branches. Outputs a collision report or an empty-state message.
+
+Display the script's stdout directly. No plan mode. Stop here.
+
+---
+
 ### Fetch ticket workflow (default)
 
 ### Step 1: Validate environment

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

@@ -106,6 +106,10 @@ export function parseCommand(args) {
     return { command: 'update-skill', args: args.slice(1) };
   }
 
+  if (first === 'collisions') {
+    return { command: 'collisions', args: args.slice(1) };
+  }
+
   // Anything that looks like a ticket key or any non-flag arg → fetch
   return { command: 'fetch', args };
 }

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

@@ -38,6 +38,7 @@ export function printHelp({ stream = process.stdout } = {}) {
     `    ${s.brand('ticketlens')} ${s.dim('<TICKET-KEY>')} ${s.dim('[options]')}   Fetch a ticket brief`,
     `    ${s.brand('ticketlens')} get ${s.dim('<TICKET-KEY>')}         Same as above ${s.dim('(explicit alias)')}`,
     `    ${s.brand('ticketlens')} triage ${s.dim('[options]')}         Scan your assigned tickets`,
+    `    ${s.brand('ticketlens')} collisions ${s.dim('[--json]')}        Show branch collisions with teammates  ${s.dim('[Team]')}`,
     `    ${s.brand('ticketlens')} review ${s.dim('[--branch=BRANCH]')}   Code-review context brief from current branch`,
     `    ${s.brand('ticketlens')} standup ${s.dim('[--since=N]')}        Standup summary from git log  ${s.dim('(last 24h by default)')}`,
     `    ${s.brand('ticketlens')} compliance ${s.dim('<TICKET-KEY>')}    Check requirements coverage  ${s.dim('[Pro/Free 3/mo]')}`,
@@ -643,6 +644,37 @@ export function printUpdateSkillHelp({ stream = process.stdout } = {}) {
   stream.write(lines.join('\n') + '\n');
 }
 
+export function printCollisionsHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('collisions')} ${s.dim('[--json] [--plain]')}`,
+    '',
+    `  Show branches where your changed files overlap with a teammate's.`,
+    `  Reads the most recent snapshot pushed by you and each teammate (within 7 days).`,
+    `  Requires a ${s.bold('Team')} license and at least one teammate in your group.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--json')}     Output raw JSON array of collision objects`,
+    `    ${s.brand('--plain')}    Plain text output ${s.dim('(no ANSI colour)')}`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}  Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens collisions`,
+    `    ${s.dim('$')} ticketlens collisions --json`,
+    `    ${s.dim('$')} ticketlens collisions --plain`,
+    '',
+    `  ${s.bold('NOTES')}`,
+    '',
+    `    Branch data is captured automatically when you run ${s.brand('ticketlens triage --push')}.`,
+    `    Snapshots older than 7 days are ignored.`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
 export function printStandupHelp({ stream = process.stdout } = {}) {
   const s = createStyler({ isTTY: stream.isTTY });
   const lines = [

package/skills/jtb/scripts/lib/triage-push.mjs

@@ -12,10 +12,15 @@ function apiBase() {
 }
 
 // Derive console queue URL from API base:
-//   http://ticketlens.test          → http://ticketlens.test/console/queue
+//   http://api.ticketlens.test      → http://ticketlens.test/console/queue
 //   https://api.ticketlens.com      → https://app.ticketlens.com/console/queue
-function queueUrl(base) {
-  return base.replace(/^(https?:\/\/)api\./, '$1app.') + '/console/queue';
+export function queueUrl(base) {
+  const noApi = base.replace(/^(https?:\/\/)api\./, '$1');
+  // Production: ticketlens.com → app.ticketlens.com
+  const console = /ticketlens\.com/.test(noApi)
+    ? noApi.replace('://', '://app.')
+    : noApi;
+  return console + '/console/queue';
 }
 
 function buildTicketPayload(scored, rawMap, baseUrl) {