mintree 0.4.6 → 0.4.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martin Mineo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,20 @@
-# mintree
+<h1 align="center">mintree</h1>
 
-> Issue-driven worktrees + Claude Code sessions for repos with an opinionated SDD+TDD flow.
+<p align="center">
+  <strong>Issue-driven Git worktrees + Claude Code sessions</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/mintree"><img src="https://img.shields.io/npm/v/mintree.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/mintree"><img src="https://img.shields.io/npm/dm/mintree.svg" alt="npm downloads"></a>
+  <a href="https://github.com/minex-labs/mintree/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/mintree.svg" alt="license"></a>
+</p>
+
+<p align="center">
+  Pick an issue, spin up an isolated worktree, and work it with Claude — for repos with an opinionated SDD+TDD flow.
+</p>
+
+---
 
 mintree wraps the steps you do manually every time a feature begins:
 

package/dist/lib/branch.d.ts

@@ -7,10 +7,16 @@
  * bare digit run (GitHub issue number — "100") or a team-prefixed Linear
  * identifier ("FE-100"); `<desc>` is lower-case kebab-case.
  *
+ * The Linear team key is normalized to upper-case: `feat/be-256-x` is
+ * accepted and rewritten to `feat/BE-256-x` (issueId "BE-256"). Linear's
+ * canonical identifier is always upper-case, so this just rescues a branch
+ * a human (or a target-repo skill) typed in the wrong case.
+ *
  * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout,
- *                      feat/BACK-100-readme-update, fix/WEB-7-modal
+ *                      feat/BACK-100-readme-update, fix/WEB-7-modal,
+ *                      feat/back-100-x (normalized to feat/BACK-100-x)
  * Examples that REJECT: feat/abc-foo, /100-foo, gh-100-foo, feat/100,
- *                       feat/100-FooBar, feat/back-100-x (lowercase prefix)
+ *                       feat/100-FooBar, Feat/BE-1-x (upper-case type)
  */
 export declare const ALLOWED_TYPES: readonly ["feat", "fix", "docs", "chore", "refactor", "test", "build", "ci", "perf", "style", "revert"];
 export type BranchType = (typeof ALLOWED_TYPES)[number];

package/dist/lib/branch.js

@@ -7,10 +7,16 @@
  * bare digit run (GitHub issue number — "100") or a team-prefixed Linear
  * identifier ("FE-100"); `<desc>` is lower-case kebab-case.
  *
+ * The Linear team key is normalized to upper-case: `feat/be-256-x` is
+ * accepted and rewritten to `feat/BE-256-x` (issueId "BE-256"). Linear's
+ * canonical identifier is always upper-case, so this just rescues a branch
+ * a human (or a target-repo skill) typed in the wrong case.
+ *
  * Examples that PARSE: feat/100-readme-update, fix/55-upload-timeout,
- *                      feat/BACK-100-readme-update, fix/WEB-7-modal
+ *                      feat/BACK-100-readme-update, fix/WEB-7-modal,
+ *                      feat/back-100-x (normalized to feat/BACK-100-x)
  * Examples that REJECT: feat/abc-foo, /100-foo, gh-100-foo, feat/100,
- *                       feat/100-FooBar, feat/back-100-x (lowercase prefix)
+ *                       feat/100-FooBar, Feat/BE-1-x (upper-case type)
  */
 export const ALLOWED_TYPES = [
     "feat",
@@ -26,11 +32,12 @@ export const ALLOWED_TYPES = [
     "revert",
 ];
 // `<type>/<issueId>-<desc>` where issueId is either `\d+` (GitHub) or
-// `<TEAM_PREFIX>-\d+` (Linear). The TEAM_PREFIX is uppercase letters/digits/
-// underscores starting with a letter, mirroring Linear's team-key
-// constraints. The full issueId captures group 2 verbatim so callers can
-// reuse it as the worktree dir name.
-const BRANCH_REGEX = /^([a-z]+)\/((?:[A-Z][A-Z0-9_]*-)?\d+)-([a-z0-9][a-z0-9-]*)$/;
+// `<TEAM_PREFIX>-\d+` (Linear). The TEAM_PREFIX is letters/digits/underscores
+// starting with a letter, mirroring Linear's team-key constraints. Both cases
+// are accepted here and the captured team key is upper-cased on the way out
+// (see `parseBranch`), so the worktree dir name and the created branch stay
+// canonical regardless of how the caller typed it.
+const BRANCH_REGEX = /^([a-z]+)\/((?:[A-Za-z][A-Za-z0-9_]*-)?\d+)-([a-z0-9][a-z0-9-]*)$/;
 export function parseBranch(branch) {
     const match = BRANCH_REGEX.exec(branch);
     if (!match) {
@@ -39,8 +46,8 @@ export function parseBranch(branch) {
             hint: "Expected `<type>/<issue>-<kebab-desc>`. Examples: feat/100-claude-md-inicial, feat/BACK-100-claude-md-inicial",
         };
     }
-    const [, type, issueId, desc] = match;
-    if (!type || !issueId || !desc) {
+    const [, type, rawIssueId, desc] = match;
+    if (!type || !rawIssueId || !desc) {
         return {
             error: `Invalid branch name: ${branch}`,
             hint: "Expected `<type>/<issue>-<kebab-desc>`. Examples: feat/100-claude-md-inicial, feat/BACK-100-claude-md-inicial",
@@ -52,8 +59,14 @@ export function parseBranch(branch) {
             hint: `Allowed types: ${ALLOWED_TYPES.join(", ")}`,
         };
     }
+    // Normalize the Linear team key to upper-case. `toUpperCase()` is a no-op
+    // for a bare-digit GitHub id ("256") and only touches the team prefix of a
+    // Linear id ("be-256" → "BE-256"). The returned `branch` is rebuilt from
+    // the normalized id so callers create/look up the canonical branch name.
+    const issueId = rawIssueId.toUpperCase();
+    const normalizedBranch = `${type}/${issueId}-${desc}`;
     return {
-        branch,
+        branch: normalizedBranch,
         type: type,
         issueId,
         desc,

package/dist/lib/providers/linear.js

@@ -504,8 +504,17 @@ export class LinearProvider {
         }
         const targetStateName = cfg.inProgressStateName;
         let targetState = targetStateName ? states.find((s) => s.name === targetStateName) : undefined;
-        if (!targetState)
-            targetState = states.find((s) => s.type === "started");
+        if (!targetState) {
+            // Linear marks BOTH "In Progress" and "In Review" as type "started",
+            // and the bootstrap query returns states unordered — so a plain
+            // `find(type === "started")` can land on "In Review". Prefer a state
+            // literally named "In Progress", otherwise pick the leftmost started
+            // state by workflow position (lowest = earliest = "In Progress").
+            const started = states.filter((s) => s.type === "started");
+            targetState =
+                started.find((s) => s.name?.toLowerCase() === "in progress") ??
+                    started.sort((a, b) => (a.position ?? 0) - (b.position ?? 0))[0];
+        }
         if (!targetState) {
             return {
                 kind: "skip-no-in-progress-option",

package/dist/lib/worktreeRemove.d.ts

@@ -17,6 +17,10 @@ export type RemoveResult = {
  *
  * Branch and metadata are deliberately preserved so a later re-attach can
  * resume the same Claude session.
+ *
+ * The branch name is NOT validated against the naming convention here:
+ * removal is a cleanup op, and a worktree on a non-canonical branch (e.g.
+ * one with a lowercase Linear team key) must still be removable.
  */
 export declare function runRemove(branchArg: string, force: boolean): RemoveResult;
 /**

package/dist/lib/worktreeRemove.js

@@ -1,4 +1,3 @@
-import { parseBranch, isParseError } from "./branch.js";
 import { findMainRepoRoot, getMintreeDir, worktreeForBranch, isDirty, removeWorktree, pruneWorktrees, pathExists, } from "./git.js";
 /**
  * Removes the worktree backing `branchArg`. Same behavior as the CLI command:
@@ -8,6 +7,10 @@ import { findMainRepoRoot, getMintreeDir, worktreeForBranch, isDirty, removeWork
  *
  * Branch and metadata are deliberately preserved so a later re-attach can
  * resume the same Claude session.
+ *
+ * The branch name is NOT validated against the naming convention here:
+ * removal is a cleanup op, and a worktree on a non-canonical branch (e.g.
+ * one with a lowercase Linear team key) must still be removable.
  */
 export function runRemove(branchArg, force) {
     const root = findMainRepoRoot();
@@ -25,15 +28,11 @@ export function runRemove(branchArg, force) {
             hint: "Run `mintree init` first.",
         };
     }
-    const parsed = parseBranch(branchArg);
-    if (isParseError(parsed)) {
-        return { ok: false, message: parsed.error, hint: parsed.hint };
-    }
-    const worktreePath = worktreeForBranch(root, parsed.branch);
+    const worktreePath = worktreeForBranch(root, branchArg);
     if (!worktreePath) {
         return {
             ok: false,
-            message: `No worktree found for branch ${parsed.branch}.`,
+            message: `No worktree found for branch ${branchArg}.`,
             hint: "Use `mintree worktree list` to see existing worktrees.",
         };
     }
@@ -49,7 +48,7 @@ export function runRemove(branchArg, force) {
         }
         return {
             ok: true,
-            branch: parsed.branch,
+            branch: branchArg,
             worktreePath,
             variant: "pruned-orphan",
             wasDirty: false,
@@ -76,7 +75,7 @@ export function runRemove(branchArg, force) {
     }
     return {
         ok: true,
-        branch: parsed.branch,
+        branch: branchArg,
         worktreePath,
         variant: "removed",
         wasDirty: dirty,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mintree",
-	"version": "0.4.6",
+	"version": "0.4.8",
 	"description": "Issue-driven git worktrees + Claude Code sessions for repos with an opinionated SDD+TDD flow.",
 	"license": "MIT",
 	"author": "Martin Mineo <mmineo@canarytechnologies.com>",