npm - brn-toolkit - Versions diffs - 1.0.0 - Mend

brn-toolkit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (48) hide show

package/GEMINI.md +92 -0
package/README.md +145 -0
package/cli/brn.ts +301 -0
package/dist/cli/brn.js +274 -0
package/dist/lib/utils.js +167 -0
package/dist/skills/github/scripts/create_pr.js +24 -0
package/dist/skills/github/scripts/get_repo_info.js +23 -0
package/dist/skills/github/scripts/list_prs.js +27 -0
package/dist/skills/github/scripts/list_repos.js +39 -0
package/dist/skills/jira/scripts/add_comment.js +36 -0
package/dist/skills/jira/scripts/get_ticket.js +45 -0
package/dist/skills/jira/scripts/list_tickets.js +42 -0
package/dist/skills/jira/scripts/update_ticket.js +30 -0
package/dist/skills/workflow/scripts/start.js +75 -0
package/dist/skills/workspace-manager/scripts/configure_workspace.js +59 -0
package/dist/skills/workspace-manager/scripts/create_workspace.js +60 -0
package/lib/utils.ts +236 -0
package/package.json +46 -0
package/skills/git-worktree/SKILL.md +49 -0
package/skills/git-worktree/scripts/clone_repo.sh +53 -0
package/skills/git-worktree/scripts/create_worktree.sh +66 -0
package/skills/git-worktree/scripts/list_worktrees.sh +39 -0
package/skills/git-worktree/scripts/remove_worktree.sh +47 -0
package/skills/github/SKILL.md +51 -0
package/skills/github/references/api_patterns.md +36 -0
package/skills/github/scripts/create_pr.ts +38 -0
package/skills/github/scripts/get_repo_info.ts +39 -0
package/skills/github/scripts/list_prs.ts +45 -0
package/skills/github/scripts/list_repos.ts +54 -0
package/skills/jira/SKILL.md +50 -0
package/skills/jira/references/api_patterns.md +59 -0
package/skills/jira/scripts/add_comment.ts +41 -0
package/skills/jira/scripts/get_ticket.ts +71 -0
package/skills/jira/scripts/list_tickets.ts +64 -0
package/skills/jira/scripts/update_ticket.ts +50 -0
package/skills/workflow/SKILL.md +94 -0
package/skills/workflow/references/coding_workflow.md +88 -0
package/skills/workflow/references/planning_workflow.md +96 -0
package/skills/workflow/references/review_workflow.md +104 -0
package/skills/workflow/scripts/start.ts +93 -0
package/skills/workspace-manager/SKILL.md +49 -0
package/skills/workspace-manager/scripts/configure_workspace.sh +87 -0
package/skills/workspace-manager/scripts/configure_workspace.ts +70 -0
package/skills/workspace-manager/scripts/create_workspace.sh +66 -0
package/skills/workspace-manager/scripts/create_workspace.ts +74 -0
package/skills/workspace-manager/scripts/get_active_workspace.sh +24 -0
package/skills/workspace-manager/scripts/list_workspaces.sh +31 -0
package/skills/workspace-manager/scripts/switch_workspace.sh +38 -0

package/skills/git-worktree/scripts/list_worktrees.sh ADDED Viewed

@@ -0,0 +1,39 @@
+#!/bin/bash
+# List all worktrees for a repository
+# Usage: list_worktrees.sh <repo_name>
+set -e
+REPO_NAME="$1"
+if [ -z "$REPO_NAME" ]; then
+    echo "Usage: list_worktrees.sh <repo_name>"
+    exit 1
+fi
+# Get the script directory to find workspace-manager
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+WORKSPACE_SCRIPT="$SCRIPT_DIR/../../workspace-manager/scripts/get_active_workspace.sh"
+if [ ! -f "$WORKSPACE_SCRIPT" ]; then
+    echo "Error: workspace-manager skill not found"
+    exit 1
+fi
+# Get workspace config
+WORKSPACE_JSON=$("$WORKSPACE_SCRIPT" --json)
+WORK_DIR=$(echo "$WORKSPACE_JSON" | yq -r '.path')
+WORK_DIR="${WORK_DIR/#\~/$HOME}"
+REPO_PATH="$WORK_DIR/$REPO_NAME"
+if [ ! -d "$REPO_PATH" ]; then
+    echo "Error: Repository not found at $REPO_PATH"
+    exit 1
+fi
+cd "$REPO_PATH"
+echo "Worktrees for $REPO_NAME:"
+echo "========================="
+git worktree list

package/skills/git-worktree/scripts/remove_worktree.sh ADDED Viewed

@@ -0,0 +1,47 @@
+#!/bin/bash
+# Remove a worktree
+# Usage: remove_worktree.sh <repo_name> <branch_name>
+set -e
+REPO_NAME="$1"
+BRANCH_NAME="$2"
+if [ -z "$REPO_NAME" ] || [ -z "$BRANCH_NAME" ]; then
+    echo "Usage: remove_worktree.sh <repo_name> <branch_name>"
+    exit 1
+fi
+# Get the script directory to find workspace-manager
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+WORKSPACE_SCRIPT="$SCRIPT_DIR/../../workspace-manager/scripts/get_active_workspace.sh"
+if [ ! -f "$WORKSPACE_SCRIPT" ]; then
+    echo "Error: workspace-manager skill not found"
+    exit 1
+fi
+# Get workspace config
+WORKSPACE_JSON=$("$WORKSPACE_SCRIPT" --json)
+WORK_DIR=$(echo "$WORKSPACE_JSON" | yq -r '.path')
+WORK_DIR="${WORK_DIR/#\~/$HOME}"
+REPO_PATH="$WORK_DIR/$REPO_NAME"
+WORKTREE_PATH="$WORK_DIR/${REPO_NAME}-worktrees/$BRANCH_NAME"
+if [ ! -d "$REPO_PATH" ]; then
+    echo "Error: Repository not found at $REPO_PATH"
+    exit 1
+fi
+if [ ! -d "$WORKTREE_PATH" ]; then
+    echo "Error: Worktree not found at $WORKTREE_PATH"
+    exit 1
+fi
+cd "$REPO_PATH"
+echo "Removing worktree for '$BRANCH_NAME'..."
+git worktree remove "$WORKTREE_PATH"
+echo "✓ Removed worktree at $WORKTREE_PATH"

package/skills/github/SKILL.md ADDED Viewed

@@ -0,0 +1,51 @@
+---
+name: brn:github
+description: |
+  Interact with GitHub API for repository and pull request management.
+  Use when: (1) Listing repositories, (2) Getting repository info, (3) Creating PRs.
+---
+# GitHub Integration
+## Description
+The GitHub skill provides tools to interact with the GitHub API directly from the CLI. It supports authentication via personal access tokens configured in the workspace.
+## Available Scripts
+### `list_repos`
+Lists repositories for a specified organization or user. Useful for discovery.
+*   **Usage**: `brn github list_repos [org_or_user]`
+*   **Arguments**:
+    *   `org_or_user` (optional): The name of the organization or user to list repositories for. If omitted, lists repositories for the authenticated user.
+*   **Example**: `brn github list_repos my-org`
+### `get_repo_info`
+Retrieves detailed information about a specific repository.
+*   **Usage**: `brn github get_repo_info <owner/repo>`
+*   **Arguments**:
+    *   `owner/repo`: The full repository name (e.g., `facebook/react`).
+*   **Example**: `brn github get_repo_info my-org/my-project`
+### `create_pr`
+Creates a Pull Request on GitHub.
+*   **Usage**: `brn github create_pr <owner/repo> <head> <base> <title>`
+*   **Arguments**:
+    *   `owner/repo`: The full repository name.
+    *   `head`: The name of the branch where your changes are implemented.
+    *   `base`: The name of the branch you want to merge into (e.g., `main`).
+    *   `title`: The title of the Pull Request.
+*   **Example**: `brn github create_pr my-org/my-project feature/login main "feat: Add login page"`
+### `list_prs`
+Lists open Pull Requests for a repository.
+*   **Usage**: `brn github list_prs <owner/repo>`
+*   **Arguments**:
+    *   `owner/repo`: The full repository name.
+*   **Example**: `brn github list_prs my-org/my-project`
+## API Reference
+See [references/api_patterns.md](references/api_patterns.md) for error handling and patterns.

package/skills/github/references/api_patterns.md ADDED Viewed

@@ -0,0 +1,36 @@
+# GitHub API Patterns
+Common patterns for GitHub API integration.
+## Authentication
+All requests use Bearer token authentication:
+```
+Authorization: Bearer <token>
+```
+## Common Endpoints
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/user/repos` | GET | List authenticated user's repos |
+| `/orgs/{org}/repos` | GET | List org repos |
+| `/repos/{owner}/{repo}` | GET | Get repo info |
+| `/repos/{owner}/{repo}/pulls` | GET | List PRs |
+| `/repos/{owner}/{repo}/pulls` | POST | Create PR |
+| `/repos/{owner}/{repo}/issues` | GET | List issues |
+## Error Handling
+| Code | Meaning | Action |
+|------|---------|--------|
+| 401 | Bad credentials | Check token |
+| 403 | Forbidden | Check token permissions |
+| 404 | Not found | Check repo name/permissions |
+| 422 | Validation failed | Check request body |
+## Rate Limiting
+- Authenticated: 5000 requests/hour
+- Check `X-RateLimit-Remaining` header
+- If rate limited, wait until `X-RateLimit-Reset` timestamp

package/skills/github/scripts/create_pr.ts ADDED Viewed

@@ -0,0 +1,38 @@
+#!/usr/bin/env npx tsx
+/**
+ * Create a pull request
+ * Usage: npx tsx create_pr.ts <owner/repo> <head> <base> <title> [body]
+ */
+import { githubRequest } from "../../../lib/utils.js";
+interface PR {
+    number: number;
+    title: string;
+    html_url: string;
+}
+const [repoPath, head, base, title, body] = process.argv.slice(2);
+if (!repoPath || !head || !base || !title) {
+    console.log(
+        "Usage: npx tsx create_pr.ts <owner/repo> <head_branch> <base_branch> <title> [body]"
+    );
+    console.log(
+        "Example: npx tsx create_pr.ts myorg/app feature-123 main 'feat: Add feature'"
+    );
+    process.exit(1);
+}
+const pr = await githubRequest<PR>(`/repos/${repoPath}/pulls`, {
+    method: "POST",
+    body: JSON.stringify({
+        title,
+        head,
+        base,
+        body: body ?? "",
+    }),
+});
+console.log(`✓ Created PR #${pr.number}: ${pr.title}`);
+console.log(`  URL: ${pr.html_url}`);
+console.log(`  ${head} → ${base}`);

package/skills/github/scripts/get_repo_info.ts ADDED Viewed

@@ -0,0 +1,39 @@
+#!/usr/bin/env npx tsx
+/**
+ * Get repository information
+ * Usage: npx tsx get_repo_info.ts <owner/repo>
+ */
+import { githubRequest } from "../../../lib/utils.js";
+interface Repo {
+    full_name: string;
+    description: string | null;
+    private: boolean;
+    default_branch: string;
+    language: string | null;
+    stargazers_count: number;
+    forks_count: number;
+    clone_url: string;
+    ssh_url: string;
+}
+const repoPath = process.argv[2];
+if (!repoPath) {
+    console.log("Usage: npx tsx get_repo_info.ts <owner/repo>");
+    console.log("Example: npx tsx get_repo_info.ts octocat/Hello-World");
+    process.exit(1);
+}
+const repo = await githubRequest<Repo>(`/repos/${repoPath}`);
+console.log(`Repository: ${repo.full_name}`);
+console.log("=".repeat(50));
+console.log(`Description: ${repo.description ?? "N/A"}`);
+console.log(`Visibility:  ${repo.private ? "Private" : "Public"}`);
+console.log(`Default:     ${repo.default_branch}`);
+console.log(`Language:    ${repo.language ?? "N/A"}`);
+console.log(`Stars:       ${repo.stargazers_count}`);
+console.log(`Forks:       ${repo.forks_count}`);
+console.log(`Clone URL:   ${repo.clone_url}`);
+console.log(`SSH URL:     ${repo.ssh_url}`);

package/skills/github/scripts/list_prs.ts ADDED Viewed

@@ -0,0 +1,45 @@
+#!/usr/bin/env npx tsx
+/**
+ * List pull requests for a repository
+ * Usage: npx tsx list_prs.ts <owner/repo> [state]
+ */
+import { githubRequest } from "../../../lib/utils.js";
+interface PR {
+    number: number;
+    title: string;
+    draft: boolean;
+    html_url: string;
+    head: { ref: string };
+    base: { ref: string };
+    user: { login: string };
+}
+const repoPath = process.argv[2];
+const state = process.argv[3] ?? "open";
+if (!repoPath) {
+    console.log("Usage: npx tsx list_prs.ts <owner/repo> [state]");
+    console.log("States: open, closed, all (default: open)");
+    process.exit(1);
+}
+const prs = await githubRequest<PR[]>(
+    `/repos/${repoPath}/pulls?state=${state}&per_page=30`
+);
+console.log(`Pull Requests for ${repoPath} (${state}):`);
+console.log("=".repeat(50));
+if (prs.length === 0) {
+    console.log("No pull requests found.");
+    process.exit(0);
+}
+for (const pr of prs) {
+    const draft = pr.draft ? "📝" : "";
+    console.log(`#${pr.number} ${draft} ${pr.title}`);
+    console.log(`   ${pr.head.ref} → ${pr.base.ref} by @${pr.user.login}`);
+    console.log(`   ${pr.html_url}`);
+    console.log();
+}

package/skills/github/scripts/list_repos.ts ADDED Viewed

@@ -0,0 +1,54 @@
+#!/usr/bin/env npx tsx
+/**
+ * List repositories for an organization or user
+ * Usage: npx tsx list_repos.ts [org_or_user]
+ */
+import { githubRequest, getActiveWorkspace } from "../../../lib/utils.js";
+interface Repo {
+    full_name: string;
+    private: boolean;
+    description: string | null;
+}
+let orgOrUser = process.argv[2];
+if (!orgOrUser) {
+    const ws = getActiveWorkspace();
+    if (ws.github_org) {
+        orgOrUser = ws.github_org;
+    }
+}
+let endpoint = "/user/repos?per_page=100";
+if (orgOrUser) {
+    endpoint = `/orgs/${orgOrUser}/repos?per_page=100`;
+}
+console.log(`Fetching repositories from: ${endpoint}`);
+try {
+    let repos = await githubRequest<Repo[]>(endpoint);
+    // If org fails, try as user
+    if (repos.length === 0 && orgOrUser) {
+        repos = await githubRequest<Repo[]>(
+            `/users/${orgOrUser}/repos?per_page=100`
+        );
+    }
+    console.log(`Repositories${orgOrUser ? ` for ${orgOrUser}` : ""}:`);
+    console.log("=".repeat(50));
+    for (const repo of repos) {
+        const icon = repo.private ? "🔒" : "🌐";
+        console.log(`${icon} ${repo.full_name}`);
+        if (repo.description) {
+            console.log(`   ${repo.description.slice(0, 60)}...`);
+        }
+        console.log();
+    }
+} catch (error) {
+    console.error("Failed to list repositories:", error);
+    process.exit(1);
+}

package/skills/jira/SKILL.md ADDED Viewed

@@ -0,0 +1,50 @@
+---
+name: brn:jira
+description: |
+  Interact with JIRA API for ticket management and tracking.
+  Use when: (1) Listing assigned tickets, (2) Getting details, (3) Updating status.
+---
+# JIRA Integration
+## Description
+The JIRA skill allows you to manage your tasks without leaving the terminal. It connects to your JIRA instance using the credentials configured in your workspace.
+## Available Scripts
+### `list_tickets`
+Lists JIRA tickets assigned to the current user. Can be filtered by status.
+*   **Usage**: `brn jira list_tickets [status]`
+*   **Arguments**:
+    *   `status` (optional): Filter tickets by status (e.g., "In Progress", "To Do").
+*   **Example**: `brn jira list_tickets "In Progress"`
+### `get_ticket`
+Retrieves detailed information about a specific JIRA ticket.
+*   **Usage**: `brn jira get_ticket <ticket_key>`
+*   **Arguments**:
+    *   `ticket_key`: The JIRA issue key (e.g., `PROJ-123`).
+*   **Example**: `brn jira get_ticket PROJ-123`
+### `update_ticket`
+Updates the status (transition) of a JIRA ticket.
+*   **Usage**: `brn jira update_ticket <ticket_key> <transition>`
+*   **Arguments**:
+    *   `ticket_key`: The JIRA issue key.
+    *   `transition`: The name of the transition/status to move to (e.g., "In Progress", "Done").
+*   **Example**: `brn jira update_ticket PROJ-123 "In Progress"`
+### `add_comment`
+Adds a comment to a JIRA ticket.
+*   **Usage**: `brn jira add_comment <ticket_key> <comment>`
+*   **Arguments**:
+    *   `ticket_key`: The JIRA issue key.
+    *   `comment`: The text content of the comment.
+*   **Example**: `brn jira add_comment PROJ-123 "Released in version 1.2.0"`
+## API Reference
+See [references/api_patterns.md](references/api_patterns.md) for patterns.

package/skills/jira/references/api_patterns.md ADDED Viewed

@@ -0,0 +1,59 @@
+# JIRA API Patterns
+Common patterns for JIRA Cloud API integration.
+## Authentication
+JIRA Cloud uses Basic Auth with email and API token:
+```
+Authorization: Basic base64(email:api_token)
+```
+Create API token at: https://id.atlassian.com/manage-profile/security/api-tokens
+## Common Endpoints
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/rest/api/3/search` | GET | Search issues with JQL |
+| `/rest/api/3/issue/{key}` | GET | Get issue details |
+| `/rest/api/3/issue/{key}/transitions` | GET | Get available transitions |
+| `/rest/api/3/issue/{key}/transitions` | POST | Transition issue |
+| `/rest/api/3/issue/{key}/comment` | POST | Add comment |
+## JQL Examples
+```
+# My open tickets
+assignee = currentUser() AND status != Done
+# In progress in a project
+project = PROJ AND status = "In Progress"
+# Recently updated
+assignee = currentUser() ORDER BY updated DESC
+```
+## Error Handling
+| Code | Meaning | Action |
+|------|---------|--------|
+| 401 | Unauthorized | Check email/token |
+| 403 | Forbidden | Check permissions |
+| 404 | Not found | Check issue key |
+## ADF Format
+JIRA API v3 uses Atlassian Document Format for rich text:
+```json
+{
+  "type": "doc",
+  "version": 1,
+  "content": [
+    {
+      "type": "paragraph",
+      "content": [{"type": "text", "text": "Hello"}]
+    }
+  ]
+}
+```

package/skills/jira/scripts/add_comment.ts ADDED Viewed

@@ -0,0 +1,41 @@
+#!/usr/bin/env npx tsx
+/**
+ * Add a comment to a JIRA ticket
+ * Usage: npx tsx add_comment.ts <ticket_key> <comment>
+ */
+import { jiraRequest } from "../../../lib/utils.js";
+const ticketKey = process.argv[2];
+const commentText = process.argv.slice(3).join(" ");
+if (!ticketKey || !commentText) {
+    console.log("Usage: npx tsx add_comment.ts <ticket_key> <comment>");
+    console.log("Example: npx tsx add_comment.ts PROJ-123 'PR created: https://...'");
+    process.exit(1);
+}
+// JIRA API v3 uses ADF format for comments
+const body = {
+    body: {
+        type: "doc",
+        version: 1,
+        content: [
+            {
+                type: "paragraph",
+                content: [
+                    {
+                        type: "text",
+                        text: commentText,
+                    },
+                ],
+            },
+        ],
+    },
+};
+await jiraRequest(`/rest/api/3/issue/${ticketKey}/comment`, {
+    method: "POST",
+    body: JSON.stringify(body),
+});
+console.log(`✓ Added comment to ${ticketKey}`);

package/skills/jira/scripts/get_ticket.ts ADDED Viewed

@@ -0,0 +1,71 @@
+#!/usr/bin/env npx tsx
+/**
+ * Get JIRA ticket details
+ * Usage: npx tsx get_ticket.ts <ticket_key>
+ */
+import { jiraRequest, getJiraConfig } from "../../../lib/utils.js";
+interface Issue {
+    key: string;
+    fields: {
+        summary: string;
+        status: { name: string };
+        issuetype: { name: string };
+        priority: { name: string } | null;
+        assignee: { displayName: string } | null;
+        reporter: { displayName: string } | null;
+        created: string;
+        updated: string;
+        description: unknown;
+    };
+}
+function extractText(node: unknown): string {
+    if (typeof node !== "object" || node === null) return "";
+    const obj = node as Record<string, unknown>;
+    if (obj.type === "text" && typeof obj.text === "string") {
+        return obj.text;
+    }
+    if (Array.isArray(obj.content)) {
+        return obj.content.map(extractText).join(" ");
+    }
+    return "";
+}
+const ticketKey = process.argv[2];
+if (!ticketKey) {
+    console.log("Usage: npx tsx get_ticket.ts <ticket_key>");
+    console.log("Example: npx tsx get_ticket.ts PROJ-123");
+    process.exit(1);
+}
+const { url } = getJiraConfig();
+const issue = await jiraRequest<Issue>(`/rest/api/3/issue/${ticketKey}`);
+const { fields } = issue;
+console.log(`Ticket: ${issue.key}`);
+console.log("=".repeat(60));
+console.log(`Summary:     ${fields.summary}`);
+console.log(`Status:      ${fields.status.name}`);
+console.log(`Type:        ${fields.issuetype.name}`);
+console.log(`Priority:    ${fields.priority?.name ?? "None"}`);
+console.log(`Assignee:    ${fields.assignee?.displayName ?? "Unassigned"}`);
+console.log(`Reporter:    ${fields.reporter?.displayName ?? "Unknown"}`);
+console.log(`Created:     ${fields.created.slice(0, 10)}`);
+console.log(`Updated:     ${fields.updated.slice(0, 10)}`);
+console.log();
+if (fields.description) {
+    console.log("Description:");
+    console.log("-".repeat(40));
+    console.log(extractText(fields.description));
+}
+console.log();
+console.log(`URL: ${url}/browse/${issue.key}`);

package/skills/jira/scripts/list_tickets.ts ADDED Viewed

@@ -0,0 +1,64 @@
+#!/usr/bin/env npx tsx
+/**
+ * List JIRA tickets assigned to current user
+ * Usage: npx tsx list_tickets.ts [status]
+ */
+import { jiraRequest } from "../../../lib/utils.js";
+interface Issue {
+    key: string;
+    fields: {
+        summary: string;
+        status: { name: string };
+        priority: { name: string } | null;
+    };
+}
+interface SearchResult {
+    issues: Issue[];
+}
+const statusFilter = process.argv[2];
+let jql = "assignee = currentUser() ORDER BY updated DESC";
+if (statusFilter) {
+    jql = `assignee = currentUser() AND status = "${statusFilter}" ORDER BY updated DESC`;
+}
+const data = await jiraRequest<SearchResult>("/rest/api/3/search/jql", {
+    method: "POST",
+    body: JSON.stringify({
+        jql,
+        maxResults: 20,
+        fields: ["summary", "status", "priority"],
+    }),
+});
+const issues = data.issues;
+console.log(`Your Tickets (${issues.length} found):`);
+console.log("=".repeat(60));
+if (issues.length === 0) {
+    console.log("No tickets found.");
+    process.exit(0);
+}
+const statusEmoji: Record<string, string> = {
+    "To Do": "📋",
+    "In Progress": "🔧",
+    "Code Review": "👀",
+    Done: "✅",
+};
+for (const issue of issues) {
+    const { key, fields } = issue;
+    const summary = fields.summary.slice(0, 50);
+    const status = fields.status.name;
+    const priority = fields.priority?.name ?? "None";
+    const emoji = statusEmoji[status] ?? "📌";
+    console.log(`${emoji} ${key}: ${summary}`);
+    console.log(`   Status: ${status} | Priority: ${priority}`);
+    console.log();
+}

package/skills/jira/scripts/update_ticket.ts ADDED Viewed

@@ -0,0 +1,50 @@
+#!/usr/bin/env npx tsx
+/**
+ * Update JIRA ticket status via transition
+ * Usage: npx tsx update_ticket.ts <ticket_key> <target_status>
+ */
+import { jiraRequest } from "../../../lib/utils.js";
+interface Transition {
+    id: string;
+    name: string;
+}
+interface TransitionsResponse {
+    transitions: Transition[];
+}
+const [ticketKey, targetStatus] = process.argv.slice(2);
+if (!ticketKey || !targetStatus) {
+    console.log("Usage: npx tsx update_ticket.ts <ticket_key> <target_status>");
+    console.log("Example: npx tsx update_ticket.ts PROJ-123 'In Progress'");
+    process.exit(1);
+}
+// Get available transitions
+const { transitions } = await jiraRequest<TransitionsResponse>(
+    `/rest/api/3/issue/${ticketKey}/transitions`
+);
+// Find matching transition (case-insensitive)
+const transition = transitions.find(
+    (t) => t.name.toLowerCase() === targetStatus.toLowerCase()
+);
+if (!transition) {
+    console.error(`Error: Transition '${targetStatus}' not available`);
+    console.error("Available transitions:");
+    for (const t of transitions) {
+        console.error(`  - ${t.name}`);
+    }
+    process.exit(1);
+}
+// Perform transition
+await jiraRequest(`/rest/api/3/issue/${ticketKey}/transitions`, {
+    method: "POST",
+    body: JSON.stringify({ transition: { id: transition.id } }),
+});
+console.log(`✓ Transitioned ${ticketKey} to '${targetStatus}'`);