brn-toolkit 1.0.0 → 1.0.2

package/dist/lib/utils.js

@@ -118,15 +118,19 @@ export function getJiraConfig() {
 export async function githubRequest(endpoint, options = {}) {
     const token = getGitHubToken();
     console.log(`[GitHub API] Requesting: ${endpoint}`);
-    const response = await fetch(`https://api.github.com${endpoint}`, {
+    const url = `https://api.github.com${endpoint}`;
+    const headers = {
+        Authorization: `Bearer ${token}`,
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28",
+        "Content-Type": "application/json",
+        ...options.headers,
+    };
+    console.log(`  URL: ${url}`);
+    console.log(`  Headers: ${JSON.stringify(headers, null, 2)}`);
+    const response = await fetch(url, {
         ...options,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            Accept: "application/vnd.github+json",
-            "X-GitHub-Api-Version": "2022-11-28",
-            "Content-Type": "application/json",
-            ...options.headers,
-        },
+        headers,
     });
     if (!response.ok) {
         const error = await response.json().catch(() => ({}));

package/dist/skills/github/scripts/get_issue.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env npx tsx
+/**
+ * Get GitHub issue details
+ * Usage: npx tsx get_issue.ts <owner/repo/issues/number> or <owner/repo> <issue_number>
+ */
+import { githubRequest } from "../../../lib/utils.js";
+async function main() {
+    let repoPath = process.argv[2];
+    let issueNumber = process.argv[3];
+    // Handle URL-like format: owner/repo/issues/123
+    if (repoPath && repoPath.includes("/issues/")) {
+        const parts = repoPath.split("/");
+        issueNumber = parts.pop();
+        parts.pop(); // remove 'issues'
+        repoPath = parts.join("/");
+    }
+    if (!repoPath || !issueNumber) {
+        console.log("Usage: npx tsx get_issue.ts <owner/repo> <issue_number>");
+        console.log("Example: npx tsx get_issue.ts octocat/Hello-World 1");
+        process.exit(1);
+    }
+    const issue = await githubRequest(`/repos/${repoPath}/issues/${issueNumber}`);
+    console.log(`Issue: #${issue.number} ${issue.title}`);
+    console.log("=".repeat(60));
+    console.log(`Status:      ${issue.state.toUpperCase()}`);
+    console.log(`Author:      @${issue.user.login}`);
+    console.log(`Assignee:    ${issue.assignee ? "@" + issue.assignee.login : "Unassigned"}`);
+    console.log(`Labels:      ${issue.labels.map(l => l.name).join(", ") || "None"}`);
+    console.log(`Created:     ${issue.created_at.slice(0, 10)}`);
+    console.log(`Updated:     ${issue.updated_at.slice(0, 10)}`);
+    console.log();
+    if (issue.body) {
+        console.log("Description:");
+        console.log("-".repeat(40));
+        console.log(issue.body);
+    }
+    else {
+        console.log("No description provided.");
+    }
+    console.log();
+    console.log(`URL: ${issue.html_url}`);
+}
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/dist/skills/github/scripts/get_repo_info.js

@@ -4,20 +4,26 @@
  * Usage: npx tsx get_repo_info.ts <owner/repo>
  */
 import { githubRequest } from "../../../lib/utils.js";
-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);
+async function main() {
+    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(`/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}`);
 }
-const repo = await githubRequest(`/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}`);
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/dist/skills/github/scripts/list_prs.js

@@ -4,24 +4,30 @@
  * Usage: npx tsx list_prs.ts <owner/repo> [state]
  */
 import { githubRequest } from "../../../lib/utils.js";
-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(`/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();
+async function main() {
+    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(`/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();
+    }
 }
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/dist/skills/jira/scripts/get_ticket.js

@@ -16,30 +16,36 @@ function extractText(node) {
     }
     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(`/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));
+async function main() {
+    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(`/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}`);
 }
-console.log();
-console.log(`URL: ${url}/browse/${issue.key}`);
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/dist/skills/workflow/scripts/start.js

@@ -1,38 +1,94 @@
 #!/usr/bin/env npx tsx
 /**
- * Initiate a new development workflow for a JIRA ticket
- * Usage: npx tsx start.ts <ticket_id>
+ * Initiate a new development workflow for a task (JIRA ticket or GitHub issue)
+ * Usage: npx tsx start.ts <task_id_or_url>
  */
 import { $ } from "zx";
-import { getActiveWorkspace, jiraRequest } from "../../../lib/utils.js";
+import { getActiveWorkspace, jiraRequest, githubRequest, checkAutomation } from "../../../lib/utils.js";
 import { join } from "path";
 import { homedir } from "os";
 $.verbose = false;
-const ticketId = process.argv[2];
-if (!ticketId) {
-    console.log("Usage: npx tsx start.ts <ticket_id>");
-    console.log("Example: npx tsx start.ts PROJ-123");
+const input = process.argv[2];
+if (!input) {
+    console.log("Usage: npx tsx start.ts <task_id_or_url>");
+    console.log("Example (JIRA): npx tsx start.ts PROJ-123");
+    console.log("Example (GitHub): npx tsx start.ts https://github.com/owner/repo/issues/42");
     process.exit(1);
 }
-async function run() {
-    console.log(`🚀 Initiating workflow for ${ticketId}...`);
-    // 1. Fetch ticket details
-    console.log(`📋 Fetching ticket ${ticketId}...`);
+async function fetchTaskDetails(input) {
+    const workspace = getActiveWorkspace();
+    // 1. GitHub URL: https://github.com/owner/repo/issues/123
+    const githubUrlMatch = input.match(/https:\/\/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)/);
+    if (githubUrlMatch) {
+        const [, owner, repo, issueNumber] = githubUrlMatch;
+        const repoPath = `${owner}/${repo}`;
+        console.log(`📋 Fetching GitHub issue ${issueNumber} from ${repoPath}...`);
+        const issue = await githubRequest(`/repos/${repoPath}/issues/${issueNumber}`);
+        return {
+            id: issueNumber,
+            summary: issue.title,
+            description: issue.body ?? "",
+            source: "github",
+            url: issue.html_url,
+            repoPath: repoPath,
+            repoName: repo
+        };
+    }
+    // 2. JIRA URL: https://org.atlassian.net/browse/PROJ-123
+    const jiraUrlMatch = input.match(/https:\/\/([^/]+)\.atlassian\.net\/browse\/([A-Z]+-\d+)/);
+    if (jiraUrlMatch) {
+        const [, , ticketId] = jiraUrlMatch;
+        return fetchJiraTicket(ticketId);
+    }
+    // 3. JIRA ID: PROJ-123
+    const jiraIdMatch = input.match(/^[A-Z]+-\d+$/);
+    if (jiraIdMatch) {
+        return fetchJiraTicket(input);
+    }
+    // 4. Fallback to default ticketing system if it's just a number
+    if (/^\d+$/.test(input) && workspace.default_ticketing_system === "github") {
+        console.error("❌ Error: For GitHub issues, please provide the full URL or owner/repo context.");
+        process.exit(1);
+    }
+    // If it looks like a JIRA ID but didn't match (e.g. lowercase), try anyway if default is jira
+    if (workspace.default_ticketing_system === "jira") {
+        return fetchJiraTicket(input);
+    }
+    console.error("❌ Error: Could not identify task source. Please provide a valid JIRA ID or GitHub Issue URL.");
+    process.exit(1);
+}
+async function fetchJiraTicket(ticketId) {
+    const { jira_url } = getActiveWorkspace();
+    console.log(`📋 Fetching JIRA ticket ${ticketId}...`);
     const ticket = await jiraRequest(`/rest/api/3/issue/${ticketId}`);
-    const summary = ticket.fields.summary;
-    const projectKey = ticket.fields.project.key;
-    console.log(`✅ Ticket found: ${summary}`);
-    // 2. Identify repo (simple heuristic or prompt)
-    // For now, let's look for repos in the workspace
+    function extractText(node) {
+        if (!node)
+            return "";
+        if (typeof node === "string")
+            return node;
+        if (node.type === "text")
+            return node.text;
+        if (Array.isArray(node.content))
+            return node.content.map(extractText).join(" ");
+        return "";
+    }
+    return {
+        id: ticketId,
+        summary: ticket.fields.summary,
+        description: extractText(ticket.fields.description),
+        source: "jira",
+        url: `${jira_url}/browse/${ticketId}`
+    };
+}
+async function run() {
+    const task = await fetchTaskDetails(input);
+    console.log(`✅ Task found: ${task.summary}`);
     const workspace = getActiveWorkspace();
     let workDir = workspace.path;
     if (workDir.startsWith("~")) {
         workDir = join(homedir(), workDir.slice(1));
     }
-    // In a real scenario, we might have a mapping or ask the user
-    // For this automation, we'll try to find a repo that matches the project key or ask
     console.log(`📂 Searching for repositories in ${workDir}...`);
-    // List directories in workDir
     const repos = (await $ `ls -d ${workDir}/*/ 2>/dev/null`.quiet()).stdout
         .split("\n")
         .map(p => p.trim())
@@ -42,27 +98,45 @@ async function run() {
         console.error("❌ No repositories found in workspace. Please clone a repo first using git-worktree:clone.");
         process.exit(1);
     }
+    // Try to match repoName if available
     let selectedRepo = repos[0];
-    if (repos.length > 1) {
+    if (task.repoName && repos.includes(task.repoName)) {
+        selectedRepo = task.repoName;
+        console.log(`🎯 Matched repository: ${selectedRepo}`);
+    }
+    else if (repos.length > 1) {
         console.log("Multiple repositories found:");
         repos.forEach((r, i) => console.log(`  ${i + 1}. ${r}`));
-        console.log(`Using ${selectedRepo} (default). To use another, clone it or configure mapping.`);
+        console.log(`Using ${selectedRepo} (default).`);
     }
-    // 3. Create branch name
-    const branchName = `${ticketId}-${summary.toLowerCase().replace(/[^a-z0-9]/g, "-").slice(0, 30)}`;
-    // 4. Create worktree
+    // Create branch name
+    const branchName = `${task.id}-${task.summary.toLowerCase().replace(/[^a-z0-9]/g, "-").slice(0, 30)}`;
+    // Create worktree
     console.log(`🌿 Creating worktree for branch ${branchName}...`);
     const createWorktreeScript = join(process.cwd(), "skills/git-worktree/scripts/create_worktree.sh");
     await $ `${createWorktreeScript} ${selectedRepo} ${branchName}`;
-    // 5. Update ticket status
-    console.log(`🔄 Updating ticket status to 'In Progress'...`);
-    const updateTicketScript = join(process.cwd(), "skills/jira/scripts/update_ticket.ts");
-    await $ `npx tsx ${updateTicketScript} ${ticketId} "In Progress"`.quiet();
+    // Update status/comment
+    if (task.source === "jira") {
+        console.log(`🔄 Updating JIRA status to 'In Progress'...`);
+        const updateTicketScript = join(process.cwd(), "skills/jira/scripts/update_ticket.ts");
+        await $ `npx tsx ${updateTicketScript} ${task.id} "In Progress"`.quiet();
+    }
+    else if (task.source === "github") {
+        if (checkAutomation("github_auto_comment", "Post a comment on the GitHub issue")) {
+            console.log(`💬 Adding comment to GitHub issue...`);
+            await githubRequest(`/repos/${task.repoPath}/issues/${task.id}/comments`, {
+                method: "POST",
+                body: JSON.stringify({
+                    body: `🚀 Started working on this issue. Branch: \`${branchName}\``
+                })
+            });
+        }
+    }
     const worktreePath = join(workDir, `${selectedRepo}-worktrees`, branchName);
     console.log("\n" + "=".repeat(50));
     console.log(`✅ Workflow initiated successfully!`);
     console.log(`📍 Worktree: ${worktreePath}`);
-    console.log(`🔗 Ticket: ${workspace.jira_url}/browse/${ticketId}`);
+    console.log(`🔗 Task: ${task.url}`);
     console.log("=".repeat(50));
     console.log(`
 Next steps:

package/dist/skills/workspace-manager/scripts/create_workspace.js

@@ -10,9 +10,10 @@ import YAML from "yaml";
 import { saveBrnConfig } from "../../../lib/utils.js";
 const workspaceName = process.argv[2];
 let workDir = process.argv[3];
+const defaultTicketing = process.argv[4];
 if (!workspaceName || !workDir) {
-    console.log("Usage: create_workspace.ts <name> <work_dir>");
-    console.log("Example: create_workspace.ts personal ~/dev/personal/auto");
+    console.log("Usage: create_workspace.ts <name> <work_dir> [default_ticketing]");
+    console.log("Example: create_workspace.ts personal ~/dev/personal/auto jira");
     process.exit(1);
 }
 const configPath = join(homedir(), ".brn", "config.yaml");
@@ -46,7 +47,8 @@ config.workspaces[workspaceName] = {
     path: workDir,
     github_token: null,
     jira_token: null,
-    jira_url: null
+    jira_url: null,
+    default_ticketing_system: defaultTicketing ?? "jira"
 };
 // If no active workspace, set this one
 if (!config.active_workspace) {

package/lib/utils.ts

@@ -12,6 +12,7 @@ $.verbose = false;
 export interface AutomationConfig {
     github_auto_push?: boolean;
     github_auto_pr?: boolean;
+    github_auto_comment?: boolean;
     jira_auto_transition?: boolean;
     jira_auto_comment?: boolean;
 }
@@ -23,6 +24,7 @@ export interface WorkspaceConfig {
     jira_token?: string | null;
     jira_url?: string | null;
     jira_email?: string | null;
+    default_ticketing_system?: "jira" | "github" | null;
     automation?: AutomationConfig;
 }
 
@@ -179,15 +181,19 @@ export async function githubRequest<T>(
 
     console.log(`[GitHub API] Requesting: ${endpoint}`);
 
-    const response = await fetch(`https://api.github.com${endpoint}`, {
-        ...options,
-        headers: {
+    const url = `https://api.github.com${endpoint}`;
+    const headers = {
             Authorization: `Bearer ${token}`,
             Accept: "application/vnd.github+json",
             "X-GitHub-Api-Version": "2022-11-28",
             "Content-Type": "application/json",
             ...options.headers,
-        },
+        };
+    console.log(`  URL: ${url}`);
+    console.log(`  Headers: ${JSON.stringify(headers, null, 2)}`);
+    const response = await fetch(url, {
+        ...options,
+        headers,
     });
 
     if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brn-toolkit",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "AI Developer Workflow Toolkit - Skills for Claude Code and Copilot CLI",
   "type": "module",
   "author": "zfael",
@@ -27,6 +27,7 @@
     "setup": "npx tsx cli/brn.ts setup",
     "github:repos": "npx tsx skills/github/scripts/list_repos.ts",
     "github:repo": "npx tsx skills/github/scripts/get_repo_info.ts",
+    "github:issue": "npx tsx skills/github/scripts/get_issue.ts",
     "github:pr:create": "npx tsx skills/github/scripts/create_pr.ts",
     "github:pr:list": "npx tsx skills/github/scripts/list_prs.ts",
     "jira:tickets": "npx tsx skills/jira/scripts/list_tickets.ts",

package/skills/git-worktree/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: brn:git-worktree
+name: brn-toolkit:git-worktree
 description: |
   Manage git repositories using the worktree pattern.
   This allows multiple branches to be checked out simultaneously in sibling directories.

package/skills/github/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: brn:github
+name: brn-toolkit:github
 description: |
   Interact with GitHub API for repository and pull request management.
   Use when: (1) Listing repositories, (2) Getting repository info, (3) Creating PRs.

package/skills/github/scripts/get_issue.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env npx tsx
+/**
+ * Get GitHub issue details
+ * Usage: npx tsx get_issue.ts <owner/repo/issues/number> or <owner/repo> <issue_number>
+ */
+import { githubRequest } from "../../../lib/utils.js";
+
+interface Issue {
+    number: number;
+    title: string;
+    state: string;
+    body: string | null;
+    user: { login: string };
+    assignee: { login: string } | null;
+    labels: { name: string }[];
+    created_at: string;
+    updated_at: string;
+    html_url: string;
+}
+
+async function main() {
+    let repoPath = process.argv[2];
+    let issueNumber = process.argv[3];
+
+    // Handle URL-like format: owner/repo/issues/123
+    if (repoPath && repoPath.includes("/issues/")) {
+        const parts = repoPath.split("/");
+        issueNumber = parts.pop()!;
+        parts.pop(); // remove 'issues'
+        repoPath = parts.join("/");
+    }
+
+    if (!repoPath || !issueNumber) {
+        console.log("Usage: npx tsx get_issue.ts <owner/repo> <issue_number>");
+        console.log("Example: npx tsx get_issue.ts octocat/Hello-World 1");
+        process.exit(1);
+    }
+
+    const issue = await githubRequest<Issue>(`/repos/${repoPath}/issues/${issueNumber}`);
+
+    console.log(`Issue: #${issue.number} ${issue.title}`);
+    console.log("=".repeat(60));
+    console.log(`Status:      ${issue.state.toUpperCase()}`);
+    console.log(`Author:      @${issue.user.login}`);
+    console.log(`Assignee:    ${issue.assignee ? "@" + issue.assignee.login : "Unassigned"}`);
+    console.log(`Labels:      ${issue.labels.map(l => l.name).join(", ") || "None"}`);
+    console.log(`Created:     ${issue.created_at.slice(0, 10)}`);
+    console.log(`Updated:     ${issue.updated_at.slice(0, 10)}`);
+    console.log();
+
+    if (issue.body) {
+        console.log("Description:");
+        console.log("-".repeat(40));
+        console.log(issue.body);
+    } else {
+        console.log("No description provided.");
+    }
+
+    console.log();
+    console.log(`URL: ${issue.html_url}`);
+}
+
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/skills/github/scripts/get_repo_info.ts

@@ -17,23 +17,30 @@ interface Repo {
     ssh_url: string;
 }
 
-const repoPath = process.argv[2];
+async function main() {
+    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);
-}
+    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}`);
+    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}`);
+    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}`);
+}
+
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/skills/github/scripts/list_prs.ts

@@ -15,31 +15,38 @@ interface PR {
     user: { login: string };
 }
 
-const repoPath = process.argv[2];
-const state = process.argv[3] ?? "open";
+async function main() {
+    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);
-}
+    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`
-);
+    const prs = await githubRequest<PR[]>(
+        `/repos/${repoPath}/pulls?state=${state}&per_page=30`
+    );
 
-console.log(`Pull Requests for ${repoPath} (${state}):`);
-console.log("=".repeat(50));
+    console.log(`Pull Requests for ${repoPath} (${state}):`);
+    console.log("=".repeat(50));
 
-if (prs.length === 0) {
-    console.log("No pull requests found.");
-    process.exit(0);
-}
+    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();
+    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();
+    }
 }
+
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/skills/jira/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: brn:jira
+name: brn-toolkit:jira
 description: |
   Interact with JIRA API for ticket management and tracking.
   Use when: (1) Listing assigned tickets, (2) Getting details, (3) Updating status.

package/skills/jira/scripts/get_ticket.ts

@@ -36,36 +36,43 @@ function extractText(node: unknown): string {
     return "";
 }
 
-const ticketKey = process.argv[2];
+async function main() {
+    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);
-}
+    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 { url } = getJiraConfig();
+    const issue = await jiraRequest<Issue>(`/rest/api/3/issue/${ticketKey}`);
 
-const { fields } = issue;
+    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();
+    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));
+    if (fields.description) {
+        console.log("Description:");
+        console.log("-".repeat(40));
+        console.log(extractText(fields.description));
+    }
+
+    console.log();
+    console.log(`URL: ${url}/browse/${issue.key}`);
 }
 
-console.log();
-console.log(`URL: ${url}/browse/${issue.key}`);
+main().catch(err => {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+});

package/skills/workflow/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: brn:workflow
+name: brn-toolkit:workflow
 description: |
   Orchestrate the complete development workflow from ticket to PR.
   Use when: (1) Starting work on a JIRA ticket, (2) Following the planning-coding-review cycle.
@@ -50,7 +50,7 @@ Initiates work on a specific ticket. This script:
 ## Detailed Phases
 
 ### Phase 1: Initiate
-Start work on a JIRA ticket using the deterministic command:
+Start work on a JIRA ticket or Github Issue using the deterministic command:
 ```bash
 brn start PROJ-123
 ```

package/skills/workflow/scripts/start.ts

@@ -1,48 +1,119 @@
 #!/usr/bin/env npx tsx
 /**
- * Initiate a new development workflow for a JIRA ticket
- * Usage: npx tsx start.ts <ticket_id>
+ * Initiate a new development workflow for a task (JIRA ticket or GitHub issue)
+ * Usage: npx tsx start.ts <task_id_or_url>
  */
 import { $ } from "zx";
-import { getActiveWorkspace, jiraRequest } from "../../../lib/utils.js";
+import { getActiveWorkspace, jiraRequest, githubRequest, checkAutomation } from "../../../lib/utils.js";
 import { join } from "path";
 import { existsSync } from "fs";
 import { homedir } from "os";
 
 $.verbose = false;
 
-const ticketId = process.argv[2];
+const input = process.argv[2];
 
-if (!ticketId) {
-    console.log("Usage: npx tsx start.ts <ticket_id>");
-    console.log("Example: npx tsx start.ts PROJ-123");
+if (!input) {
+    console.log("Usage: npx tsx start.ts <task_id_or_url>");
+    console.log("Example (JIRA): npx tsx start.ts PROJ-123");
+    console.log("Example (GitHub): npx tsx start.ts https://github.com/owner/repo/issues/42");
     process.exit(1);
 }
 
-async function run() {
-    console.log(`🚀 Initiating workflow for ${ticketId}...`);
+interface TaskDetails {
+    id: string;
+    summary: string;
+    description: string;
+    source: "jira" | "github";
+    url: string;
+    repoPath?: string; // owner/repo
+    repoName?: string; // repo only
+}
+
+async function fetchTaskDetails(input: string): Promise<TaskDetails> {
+    const workspace = getActiveWorkspace();
+    
+    // 1. GitHub URL: https://github.com/owner/repo/issues/123
+    const githubUrlMatch = input.match(/https:\/\/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)/);
+    if (githubUrlMatch) {
+        const [, owner, repo, issueNumber] = githubUrlMatch;
+        const repoPath = `${owner}/${repo}`;
+        console.log(`📋 Fetching GitHub issue ${issueNumber} from ${repoPath}...`);
+        
+        const issue: any = await githubRequest(`/repos/${repoPath}/issues/${issueNumber}`);
+        return {
+            id: issueNumber,
+            summary: issue.title,
+            description: issue.body ?? "",
+            source: "github",
+            url: issue.html_url,
+            repoPath: repoPath,
+            repoName: repo
+        };
+    }
+
+    // 2. JIRA URL: https://org.atlassian.net/browse/PROJ-123
+    const jiraUrlMatch = input.match(/https:\/\/([^/]+)\.atlassian\.net\/browse\/([A-Z]+-\d+)/);
+    if (jiraUrlMatch) {
+        const [, , ticketId] = jiraUrlMatch;
+        return fetchJiraTicket(ticketId);
+    }
+
+    // 3. JIRA ID: PROJ-123
+    const jiraIdMatch = input.match(/^[A-Z]+-\d+$/);
+    if (jiraIdMatch) {
+        return fetchJiraTicket(input);
+    }
+
+    // 4. Fallback to default ticketing system if it's just a number
+    if (/^\d+$/.test(input) && workspace.default_ticketing_system === "github") {
+        console.error("❌ Error: For GitHub issues, please provide the full URL or owner/repo context.");
+        process.exit(1);
+    }
+
+    // If it looks like a JIRA ID but didn't match (e.g. lowercase), try anyway if default is jira
+    if (workspace.default_ticketing_system === "jira") {
+        return fetchJiraTicket(input);
+    }
+
+    console.error("❌ Error: Could not identify task source. Please provide a valid JIRA ID or GitHub Issue URL.");
+    process.exit(1);
+}
 
-    // 1. Fetch ticket details
-    console.log(`📋 Fetching ticket ${ticketId}...`);
+async function fetchJiraTicket(ticketId: string): Promise<TaskDetails> {
+    const { jira_url } = getActiveWorkspace();
+    console.log(`📋 Fetching JIRA ticket ${ticketId}...`);
     const ticket: any = await jiraRequest(`/rest/api/3/issue/${ticketId}`);
-    const summary = ticket.fields.summary;
-    const projectKey = ticket.fields.project.key;
     
-    console.log(`✅ Ticket found: ${summary}`);
+    function extractText(node: any): string {
+        if (!node) return "";
+        if (typeof node === "string") return node;
+        if (node.type === "text") return node.text;
+        if (Array.isArray(node.content)) return node.content.map(extractText).join(" ");
+        return "";
+    }
+
+    return {
+        id: ticketId,
+        summary: ticket.fields.summary,
+        description: extractText(ticket.fields.description),
+        source: "jira",
+        url: `${jira_url}/browse/${ticketId}`
+    };
+}
+
+async function run() {
+    const task = await fetchTaskDetails(input);
+    console.log(`✅ Task found: ${task.summary}`);
 
-    // 2. Identify repo (simple heuristic or prompt)
-    // For now, let's look for repos in the workspace
     const workspace = getActiveWorkspace();
     let workDir = workspace.path;
     if (workDir.startsWith("~")) {
         workDir = join(homedir(), workDir.slice(1));
     }
 
-    // In a real scenario, we might have a mapping or ask the user
-    // For this automation, we'll try to find a repo that matches the project key or ask
     console.log(`📂 Searching for repositories in ${workDir}...`);
     
-    // List directories in workDir
     const repos = (await $`ls -d ${workDir}/*/ 2>/dev/null`.quiet()).stdout
         .split("\n")
         .map(p => p.trim())
@@ -54,32 +125,48 @@ async function run() {
         process.exit(1);
     }
 
+    // Try to match repoName if available
     let selectedRepo = repos[0];
-    if (repos.length > 1) {
+    if (task.repoName && repos.includes(task.repoName)) {
+        selectedRepo = task.repoName;
+        console.log(`🎯 Matched repository: ${selectedRepo}`);
+    } else if (repos.length > 1) {
         console.log("Multiple repositories found:");
         repos.forEach((r, i) => console.log(`  ${i + 1}. ${r}`));
-        console.log(`Using ${selectedRepo} (default). To use another, clone it or configure mapping.`);
+        console.log(`Using ${selectedRepo} (default).`);
     }
 
-    // 3. Create branch name
-    const branchName = `${ticketId}-${summary.toLowerCase().replace(/[^a-z0-9]/g, "-").slice(0, 30)}`;
+    // Create branch name
+    const branchName = `${task.id}-${task.summary.toLowerCase().replace(/[^a-z0-9]/g, "-").slice(0, 30)}`;
     
-    // 4. Create worktree
+    // Create worktree
     console.log(`🌿 Creating worktree for branch ${branchName}...`);
     const createWorktreeScript = join(process.cwd(), "skills/git-worktree/scripts/create_worktree.sh");
     await $`${createWorktreeScript} ${selectedRepo} ${branchName}`;
 
-    // 5. Update ticket status
-    console.log(`🔄 Updating ticket status to 'In Progress'...`);
-    const updateTicketScript = join(process.cwd(), "skills/jira/scripts/update_ticket.ts");
-    await $`npx tsx ${updateTicketScript} ${ticketId} "In Progress"`.quiet();
+    // Update status/comment
+    if (task.source === "jira") {
+        console.log(`🔄 Updating JIRA status to 'In Progress'...`);
+        const updateTicketScript = join(process.cwd(), "skills/jira/scripts/update_ticket.ts");
+        await $`npx tsx ${updateTicketScript} ${task.id} "In Progress"`.quiet();
+    } else if (task.source === "github") {
+        if (checkAutomation("github_auto_comment", "Post a comment on the GitHub issue")) {
+            console.log(`💬 Adding comment to GitHub issue...`);
+            await githubRequest(`/repos/${task.repoPath}/issues/${task.id}/comments`, {
+                method: "POST",
+                body: JSON.stringify({
+                    body: `🚀 Started working on this issue. Branch: \`${branchName}\``
+                })
+            });
+        }
+    }
 
     const worktreePath = join(workDir, `${selectedRepo}-worktrees`, branchName);
     
     console.log("\n" + "=".repeat(50));
     console.log(`✅ Workflow initiated successfully!`);
     console.log(`📍 Worktree: ${worktreePath}`);
-    console.log(`🔗 Ticket: ${workspace.jira_url}/browse/${ticketId}`);
+    console.log(`🔗 Task: ${task.url}`);
     console.log("=".repeat(50));
     console.log(`
 Next steps:
@@ -90,4 +177,4 @@ Next steps:
 run().catch(err => {
     console.error("❌ Error initiating workflow:", err.message);
     process.exit(1);
-});
+});

package/skills/workspace-manager/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: brn:workspace-manager
+name: brn-toolkit:workspace-manager
 description: |
   Manage isolated configurations (tokens, paths) for different contexts.
 ---

package/skills/workspace-manager/scripts/create_workspace.ts

@@ -11,10 +11,11 @@ import { saveBrnConfig } from "../../../lib/utils.js";
 
 const workspaceName = process.argv[2];
 let workDir = process.argv[3];
+const defaultTicketing = process.argv[4] as "jira" | "github" | undefined;
 
 if (!workspaceName || !workDir) {
-    console.log("Usage: create_workspace.ts <name> <work_dir>");
-    console.log("Example: create_workspace.ts personal ~/dev/personal/auto");
+    console.log("Usage: create_workspace.ts <name> <work_dir> [default_ticketing]");
+    console.log("Example: create_workspace.ts personal ~/dev/personal/auto jira");
     process.exit(1);
 }
 
@@ -56,7 +57,8 @@ config.workspaces[workspaceName] = {
     path: workDir,
     github_token: null,
     jira_token: null,
-    jira_url: null
+    jira_url: null,
+    default_ticketing_system: defaultTicketing ?? "jira"
 };
 
 // If no active workspace, set this one