santree 0.2.3 → 0.2.5

package/dist/commands/dashboard.js

@@ -603,7 +603,7 @@ export default function Dashboard() {
             if (!prTemplate) {
                 dispatch({
                     type: "PR_CREATE_ERROR",
-                    error: "No PR template found at .github/pull_request_template.md",
+                    error: "No PR template found (checked .github/, docs/, and repo root)",
                 });
                 return;
             }
@@ -924,6 +924,10 @@ export default function Dashboard() {
         }
         // Open in Linear
         if (input === "o") {
+            if (!di.issue.url) {
+                dispatch({ type: "SET_ACTION_MESSAGE", message: "No Linear ticket URL" });
+                return;
+            }
             const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
             execSync(`${openCmd} "${di.issue.url}"`, { stdio: "ignore" });
             dispatch({ type: "SET_ACTION_MESSAGE", message: "Opened in browser" });

package/dist/commands/pr/create.js

@@ -56,7 +56,7 @@ export default function PR({ options }) {
             const prTemplate = getPRTemplate();
             if (!prTemplate) {
                 setStatus("error");
-                setMessage("No PR template found at .github/pull_request_template.md");
+                setMessage("No PR template found (checked .github/, docs/, and repo root)");
                 setTimeout(() => exit(), 100);
                 return;
             }

package/dist/lib/dashboard/DetailPanel.js

@@ -8,6 +8,8 @@ function stateColor(type) {
             return "blue";
         case "backlog":
             return "gray";
+        case "orphaned":
+            return "gray";
         default:
             return "yellow";
     }
@@ -47,7 +49,8 @@ function fileColor(xy) {
         return "gray";
     return "yellow";
 }
-function buildActions(worktree, pr) {
+function buildActions(di) {
+    const { worktree, pr, issue } = di;
     const items = [];
     // Work/Resume
     if (worktree?.sessionId) {
@@ -77,7 +80,9 @@ function buildActions(worktree, pr) {
         items.push({ key: "r", label: "Review", color: "cyan" });
     }
     // Links
-    items.push({ key: "o", label: "Linear", color: "gray" });
+    if (issue.url) {
+        items.push({ key: "o", label: "Linear", color: "gray" });
+    }
     if (pr)
         items.push({ key: "p", label: "Open PR", color: "gray" });
     // Destructive
@@ -210,7 +215,7 @@ export default function DetailPanel({ issue, scrollOffset, height, width, creati
         }
     }
     // ── Build actions footer ──────────────────────────────────────────
-    const actionRows = buildActions(worktree, pr);
+    const actionRows = buildActions(issue);
     // +1 for the separator line
     const actionsHeight = actionRows.length + 1;
     const scrollableHeight = height - actionsHeight;

package/dist/lib/dashboard/IssueList.js

@@ -15,6 +15,8 @@ function stateColor(type, name) {
             return "blue";
         case "backlog":
             return "gray";
+        case "orphaned":
+            return "gray";
         default:
             return "yellow";
     }

package/dist/lib/dashboard/data.js

@@ -20,9 +20,13 @@ export async function loadDashboardData(repoRoot) {
     }
     // Read metadata once for session IDs
     const metadata = readAllMetadata(repoRoot);
+    // Track which ticket IDs are consumed by fetched issues
+    const consumedTicketIds = new Set();
     // Enrich issues in parallel
     const enriched = await Promise.all(issues.map(async (issue) => {
         const wt = wtMap.get(issue.identifier);
+        if (wt)
+            consumedTicketIds.add(issue.identifier);
         let worktreeInfo = null;
         let prInfo = null;
         let checksInfo = null;
@@ -58,6 +62,56 @@ export async function loadDashboardData(repoRoot) {
             reviews: reviewsInfo,
         };
     }));
+    // Build orphan DashboardIssue objects for worktrees not matched to any fetched issue
+    const orphans = await Promise.all([...wtMap.entries()]
+        .filter(([tid]) => !consumedTicketIds.has(tid))
+        .map(async ([tid, wt]) => {
+        const base = getBaseBranch(wt.branch);
+        const [gitStatusOutput, ahead, pr] = await Promise.all([
+            getGitStatusAsync(wt.path),
+            getCommitsAheadAsync(wt.path, base),
+            getPRInfoAsync(wt.branch),
+        ]);
+        let checksInfo = null;
+        let reviewsInfo = null;
+        if (pr) {
+            [checksInfo, reviewsInfo] = await Promise.all([
+                getPRChecksAsync(pr.number),
+                getPRReviewsAsync(pr.number),
+            ]);
+        }
+        // Derive a readable title from branch name: strip prefix and ticket ID
+        const titleFromBranch = wt.branch
+            .replace(/^[^/]+\//, "") // strip prefix (e.g. "feature/")
+            .replace(/^[A-Z]+-\d+-?/, "") // strip ticket ID
+            .replace(/-/g, " ")
+            .trim() || tid;
+        return {
+            issue: {
+                identifier: tid,
+                title: titleFromBranch,
+                description: null,
+                url: "",
+                priority: 0,
+                priorityLabel: "None",
+                state: { name: "Orphaned", type: "orphaned" },
+                labels: [],
+                projectId: null,
+                projectName: null,
+            },
+            worktree: {
+                path: wt.path,
+                branch: wt.branch,
+                dirty: Boolean(gitStatusOutput),
+                commitsAhead: ahead,
+                sessionId: metadata[tid]?.session_id ?? null,
+                gitStatus: gitStatusOutput,
+            },
+            pr,
+            checks: checksInfo,
+            reviews: reviewsInfo,
+        };
+    }));
     // Group by project
     const groupMap = new Map();
     for (const di of enriched) {
@@ -98,6 +152,20 @@ export async function loadDashboardData(repoRoot) {
             statusGroups,
         };
     });
+    // Append orphaned worktrees as a separate group at the bottom
+    if (orphans.length > 0) {
+        groups.push({
+            name: "Orphaned Worktrees",
+            id: null,
+            statusGroups: [
+                {
+                    name: "Orphaned",
+                    type: "orphaned",
+                    issues: orphans,
+                },
+            ],
+        });
+    }
     const flatIssues = groups.flatMap((g) => g.statusGroups.flatMap((sg) => sg.issues));
     return { groups, flatIssues };
 }

package/dist/lib/github.d.ts

@@ -31,8 +31,10 @@ export declare function pushBranch(branchName: string, force?: boolean): boolean
  */
 export declare function createPR(title: string, baseBranch: string, headBranch: string, bodyFile?: string): number;
 /**
- * Fetch the pull request template from the repo's .github/pull_request_template.md.
- * Runs: `gh api repos/{owner}/{repo}/contents/.github/pull_request_template.md --jq .content`
+ * Fetch the pull request template from the repo.
+ * Checks all standard locations and casings that GitHub supports:
+ * .github/, docs/, and repo root — with both lowercase and uppercase filenames.
+ * https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository
  * Returns the decoded template content, or null if none exists.
  */
 export declare function getPRTemplate(): string | null;

package/dist/lib/github.js

@@ -71,15 +71,28 @@ export function createPR(title, baseBranch, headBranch, bodyFile) {
     }
 }
 /**
- * Fetch the pull request template from the repo's .github/pull_request_template.md.
- * Runs: `gh api repos/{owner}/{repo}/contents/.github/pull_request_template.md --jq .content`
+ * Fetch the pull request template from the repo.
+ * Checks all standard locations and casings that GitHub supports:
+ * .github/, docs/, and repo root — with both lowercase and uppercase filenames.
+ * https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository
  * Returns the decoded template content, or null if none exists.
  */
 export function getPRTemplate() {
-    const output = run(`gh api repos/{owner}/{repo}/contents/.github/pull_request_template.md --jq .content`);
-    if (!output)
-        return null;
-    return Buffer.from(output, "base64").toString("utf-8");
+    const paths = [
+        ".github/pull_request_template.md",
+        ".github/PULL_REQUEST_TEMPLATE.md",
+        "docs/pull_request_template.md",
+        "docs/PULL_REQUEST_TEMPLATE.md",
+        "pull_request_template.md",
+        "PULL_REQUEST_TEMPLATE.md",
+    ];
+    for (const path of paths) {
+        const output = run(`gh api repos/{owner}/{repo}/contents/${path} --jq .content`);
+        if (output) {
+            return Buffer.from(output, "base64").toString("utf-8");
+        }
+    }
+    return null;
 }
 /**
  * Fetch CI check results for a pull request (async).

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "santree",
-	"version": "0.2.3",
+	"version": "0.2.5",
 	"description": "Git worktree manager",
 	"license": "MIT",
 	"author": "Santiago Toscanini",