ticketlens 0.2.1 → 0.3.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "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.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.
@@ -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/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]')}`,