ai-sdlc 0.3.0-alpha.1 → 0.3.0-alpha.11

package/dist/core/git-utils.js

@@ -114,6 +114,64 @@ export function isLocalBehindRemote(workingDir) {
     const [behind] = output.split('\t').map(Number);
     return behind > 0;
 }
+/**
+ * Detect the base branch for the repository (main or master)
+ *
+ * @param workingDir - Working directory to check
+ * @returns 'main' or 'master' depending on which exists
+ * @throws Error if neither main nor master branch exists
+ */
+export function getBaseBranch(workingDir) {
+    // Check for 'main' first
+    const mainResult = spawnSync('git', ['rev-parse', '--verify', 'main'], {
+        cwd: workingDir,
+        encoding: 'utf-8',
+        shell: false,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (mainResult.status === 0) {
+        return 'main';
+    }
+    // Check for 'master' as fallback
+    const masterResult = spawnSync('git', ['rev-parse', '--verify', 'master'], {
+        cwd: workingDir,
+        encoding: 'utf-8',
+        shell: false,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (masterResult.status === 0) {
+        return 'master';
+    }
+    throw new Error('No base branch found. Expected "main" or "master" branch to exist.');
+}
+/**
+ * Get the merge-base (common ancestor) between a base branch and HEAD
+ *
+ * This is useful for comparing all changes on a feature branch against the base branch,
+ * rather than just comparing to the immediate parent commit (HEAD~1).
+ *
+ * @param workingDir - Working directory to check
+ * @param baseBranch - Base branch name (e.g., 'main' or 'master')
+ * @returns Commit SHA of the merge-base, or null if it cannot be determined
+ */
+export function getMergeBase(workingDir, baseBranch) {
+    try {
+        const result = spawnSync('git', ['merge-base', baseBranch, 'HEAD'], {
+            cwd: workingDir,
+            encoding: 'utf-8',
+            shell: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        if (result.status !== 0) {
+            return null;
+        }
+        const output = result.stdout?.toString().trim() || '';
+        return output || null;
+    }
+    catch {
+        return null;
+    }
+}
 export function validateGitState(workingDir, options = {}) {
     const errors = [];
     const warnings = [];

package/dist/core/git-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/core/git-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AA0BtD,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,UAAwC,EAAE;IAE1C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;QACzD,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,sFAAsF;IACtF,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IACvC,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4BAA4B;IAC5B,iFAAiF;IACjF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/C,mEAAmE;QACnE,oEAAoE;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAE7D,0CAA0C;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,iDAAiD;QACjD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,eAAgB,EAAE,CAAC;YAC/C,IAAI,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC1C,OAAO,KAAK,CAAC,CAAC,sBAAsB;YACtC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,mBAAmB;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,kBAAkB,CAAC,MAAM,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,OAAe;IAC3D,4BAA4B;IAC5B,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtD,gCAAgC;IAChC,6CAA6C;IAC7C,MAAM,YAAY,GAAG,iBAAiB;SACnC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,8CAA8C;SACnF,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,sBAAsB;SAC3D,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,8BAA8B;SACtD,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,kCAAkC;IAEzE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,oBAAoB,CAAC,EAAE;QAC9E,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;QACrE,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,oBAA8B,0BAA0B;IAExD,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;QAC3D,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,CAC7B,KAAK,EACL,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,oBAAoB,CAAC,EAC7D;QACE,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CACF,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7D,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO,MAAM,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,0BAA0B,CAAC;IAElF,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAiC,OAAO,CAAC,eAAe;YACxE,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,uBAAuB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEnD,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,aAAa,IAAI,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3F,MAAM,CAAC,IAAI,CAAC,mCAAmC,aAAa,mCAAmC,CAAC,CAAC;IACnG,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;QACR,aAAa,EAAE,aAAa,IAAI,SAAS;KAC1C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/core/git-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AA0BtD,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,UAAwC,EAAE;IAE1C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;QACzD,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,sFAAsF;IACtF,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IACvC,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4BAA4B;IAC5B,iFAAiF;IACjF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/C,mEAAmE;QACnE,oEAAoE;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAE7D,0CAA0C;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,iDAAiD;QACjD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,eAAgB,EAAE,CAAC;YAC/C,IAAI,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC1C,OAAO,KAAK,CAAC,CAAC,sBAAsB;YACtC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,mBAAmB;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,kBAAkB,CAAC,MAAM,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,OAAe;IAC3D,4BAA4B;IAC5B,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtD,gCAAgC;IAChC,6CAA6C;IAC7C,MAAM,YAAY,GAAG,iBAAiB;SACnC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,8CAA8C;SACnF,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,sBAAsB;SAC3D,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,8BAA8B;SACtD,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,kCAAkC;IAEzE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,oBAAoB,CAAC,EAAE;QAC9E,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;QACrE,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,oBAA8B,0BAA0B;IAExD,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;QAC3D,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,CAC7B,KAAK,EACL,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,oBAAoB,CAAC,EAC7D;QACE,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CACF,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7D,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO,MAAM,GAAG,CAAC,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,yBAAyB;IACzB,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;QACrE,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iCAAiC;IACjC,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE;QACzE,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,UAAkB;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;YAClE,GAAG,EAAE,UAAU;YACf,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACtD,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,0BAA0B,CAAC;IAElF,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAiC,OAAO,CAAC,eAAe;YACxE,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,uBAAuB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEnD,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,aAAa,IAAI,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3F,MAAM,CAAC,IAAI,CAAC,mCAAmC,aAAa,mCAAmC,CAAC,CAAC;IACnG,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;QACR,aAAa,EAAE,aAAa,IAAI,SAAS;KAC1C,CAAC;AACJ,CAAC"}

package/dist/core/kanban.d.ts

@@ -1,4 +1,4 @@
-import { Story, StateAssessment, KanbanFolder, StoryStatus } from '../types/index.js';
+import { Story, StateAssessment, KanbanFolder, StoryStatus, GroupingDimension, GroupingSummary } from '../types/index.js';
 /**
  * Find all stories in the stories/ folder structure
  * Globs stories/*\u200B/story.md and returns all story objects
@@ -46,4 +46,128 @@ export declare function kanbanExists(sdlcRoot: string): boolean;
  * Get board statistics
  */
 export declare function getBoardStats(sdlcRoot: string): Record<KanbanFolder, number>;
+/**
+ * Check if a label matches a glob pattern.
+ * Supports wildcard (*) for pattern matching with proper regex escaping.
+ *
+ * @param label - The label to test
+ * @param pattern - The glob pattern (e.g., 'epic-*', '*-test')
+ * @returns true if label matches pattern
+ * @throws Error if pattern exceeds maximum length
+ *
+ * @example
+ * labelMatchesPattern('epic-ticketing', 'epic-*') // true
+ * labelMatchesPattern('sprint-2024-q1', 'epic-*') // false
+ * labelMatchesPattern('test.label', 'test.label') // true (special chars escaped)
+ */
+export declare function labelMatchesPattern(label: string, pattern: string): boolean;
+/**
+ * Find stories by exact label match.
+ * Returns stories sorted by priority ascending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param label - Exact label to match
+ * @returns Array of stories with the specified label
+ *
+ * @example
+ * findStoriesByLabel(sdlcRoot, 'epic-ticketing')
+ */
+export declare function findStoriesByLabel(sdlcRoot: string, label: string): Story[];
+/**
+ * Find stories by multiple labels with AND/OR logic.
+ * Returns stories sorted by priority ascending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param labels - Array of labels to match
+ * @param mode - 'all' requires all labels (AND), 'any' requires at least one (OR)
+ * @returns Array of matching stories
+ *
+ * @example
+ * // Stories with BOTH epic-ticketing AND team-backend
+ * findStoriesByLabels(sdlcRoot, ['epic-ticketing', 'team-backend'], 'all')
+ *
+ * // Stories with EITHER epic-ticketing OR epic-auth
+ * findStoriesByLabels(sdlcRoot, ['epic-ticketing', 'epic-auth'], 'any')
+ */
+export declare function findStoriesByLabels(sdlcRoot: string, labels: string[], mode: 'all' | 'any'): Story[];
+/**
+ * Find stories by glob pattern matching on labels.
+ * Returns deduplicated stories sorted by priority ascending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param pattern - Glob pattern (e.g., 'epic-*', '*-test', 'team-*-backend')
+ * @returns Array of stories with at least one matching label
+ *
+ * @example
+ * findStoriesByPattern(sdlcRoot, 'epic-*') // All stories with epic-* labels
+ * findStoriesByPattern(sdlcRoot, '*-test') // All stories with *-test labels
+ */
+export declare function findStoriesByPattern(sdlcRoot: string, pattern: string): Story[];
+/**
+ * Get all unique labels across all stories.
+ * Returns labels sorted alphabetically.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @returns Sorted array of unique labels
+ *
+ * @example
+ * getUniqueLabels(sdlcRoot) // ['epic-auth', 'epic-ticketing', 'team-backend', ...]
+ */
+export declare function getUniqueLabels(sdlcRoot: string): string[];
+/**
+ * Get grouping summaries for a specific dimension.
+ * Returns groupings sorted by story count descending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param dimension - Grouping dimension ('thematic', 'temporal', 'structural')
+ * @returns Array of grouping summaries with story counts and status breakdowns
+ *
+ * @example
+ * getGroupings(sdlcRoot, 'thematic')
+ * // [
+ * //   { id: 'ticketing', label: 'epic-ticketing', dimension: 'thematic',
+ * //     storyCount: 5, statusBreakdown: { backlog: 2, ready: 1, ... } },
+ * //   ...
+ * // ]
+ */
+export declare function getGroupings(sdlcRoot: string, dimension: GroupingDimension): GroupingSummary[];
+/**
+ * Find stories by epic label (convenience wrapper).
+ * Queries for stories with 'epic-{epicId}' label.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param epicId - Epic identifier (without 'epic-' prefix)
+ * @returns Array of stories with the specified epic label
+ *
+ * @example
+ * findStoriesByEpic(sdlcRoot, 'ticketing-integration')
+ * // Returns stories with label 'epic-ticketing-integration'
+ */
+export declare function findStoriesByEpic(sdlcRoot: string, epicId: string): Story[];
+/**
+ * Find stories by sprint label (convenience wrapper).
+ * Queries for stories with 'sprint-{sprintId}' label.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param sprintId - Sprint identifier (without 'sprint-' prefix)
+ * @returns Array of stories with the specified sprint label
+ *
+ * @example
+ * findStoriesBySprint(sdlcRoot, '2024-q1')
+ * // Returns stories with label 'sprint-2024-q1'
+ */
+export declare function findStoriesBySprint(sdlcRoot: string, sprintId: string): Story[];
+/**
+ * Find stories by team label (convenience wrapper).
+ * Queries for stories with 'team-{teamId}' label.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param teamId - Team identifier (without 'team-' prefix)
+ * @returns Array of stories with the specified team label
+ *
+ * @example
+ * findStoriesByTeam(sdlcRoot, 'backend')
+ * // Returns stories with label 'team-backend'
+ */
+export declare function findStoriesByTeam(sdlcRoot: string, teamId: string): Story[];
 //# sourceMappingURL=kanban.d.ts.map

package/dist/core/kanban.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kanban.d.ts","sourceRoot":"","sources":["../../src/core/kanban.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,eAAe,EAA0B,YAAY,EAA+D,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAK3K;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CA6BxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAalF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,CAclF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,CAiC1E;AAKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAG5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAO7D;AAeD;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA6M5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAItD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAa5E"}
+{"version":3,"file":"kanban.d.ts","sourceRoot":"","sources":["../../src/core/kanban.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,eAAe,EAA0B,YAAY,EAA+D,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAqB,MAAM,mBAAmB,CAAC;AA+FlO;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CAiCxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAalF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,CAclF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,CAiC1E;AAKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAG5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAO7D;AAeD;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA6M5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAItD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAa5E;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAsB3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAa3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,KAAK,GAAG,KAAK,GAClB,KAAK,EAAE,CA0BT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CA+B/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAW1D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAoE9F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CAE3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CAE/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CAE3E"}

package/dist/core/kanban.js

@@ -1,10 +1,90 @@
 import fs from 'fs';
 import path from 'path';
 import { glob } from 'glob';
-import { KANBAN_FOLDERS, ReviewDecision, STORIES_FOLDER, STORY_FILENAME } from '../types/index.js';
+import { KANBAN_FOLDERS, ReviewDecision, STORIES_FOLDER, STORY_FILENAME, DEFAULT_GROUPINGS } from '../types/index.js';
 import { parseStory, isAtMaxRetries, canRetryRefinement, getLatestReviewAttempt, moveToBlocked, getEffectiveMaxRetries, sanitizeReasonText } from './story.js';
 import { loadConfig } from './config.js';
 import { determineTargetPhase } from '../agents/rework.js';
+import { GitWorktreeService } from './worktree.js';
+/**
+ * Load stories from active worktrees.
+ * Returns a map of story ID to story object for all stories found in worktrees.
+ * Handles missing files, parse errors, and deleted worktrees gracefully with logging.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @returns Map of story ID to story object from worktrees
+ */
+function loadStoriesFromWorktrees(sdlcRoot) {
+    const worktreeMap = new Map();
+    try {
+        // Determine worktree base path and project root
+        const projectRoot = path.dirname(sdlcRoot);
+        const worktreeBasePath = path.join(sdlcRoot, 'worktrees');
+        // Get list of active worktrees
+        const worktreeService = new GitWorktreeService(projectRoot, worktreeBasePath);
+        const worktrees = worktreeService.list();
+        for (const worktree of worktrees) {
+            // Skip worktrees that don't exist on filesystem
+            if (!worktree.exists) {
+                continue;
+            }
+            // Skip worktrees without a story ID
+            if (!worktree.storyId) {
+                continue;
+            }
+            // Construct expected story path in worktree
+            // Pattern: {worktreePath}/stories/{storyId}/story.md
+            const storyPath = path.join(worktree.path, STORIES_FOLDER, worktree.storyId, STORY_FILENAME);
+            // Check if story file exists
+            if (!fs.existsSync(storyPath)) {
+                console.warn(`Worktree story file missing for ${worktree.storyId}: ${storyPath}`);
+                continue;
+            }
+            try {
+                // Parse the story from worktree
+                const canonicalPath = fs.realpathSync(storyPath);
+                const story = parseStory(canonicalPath);
+                worktreeMap.set(worktree.storyId, { ...story, path: canonicalPath });
+            }
+            catch (err) {
+                // Log parse error and continue
+                const errorMsg = err instanceof Error ? err.message : 'Unknown error';
+                console.error(`Failed to parse worktree story ${worktree.storyId} at ${storyPath}: ${errorMsg}`);
+                continue;
+            }
+        }
+    }
+    catch (err) {
+        // If worktree listing fails, log error but return empty map (graceful fallback)
+        const errorMsg = err instanceof Error ? err.message : 'Unknown error';
+        console.error(`Failed to load worktree stories: ${errorMsg}`);
+    }
+    return worktreeMap;
+}
+/**
+ * Merge main repository stories with worktree stories.
+ * Worktree versions take precedence over main repo versions for the same story ID.
+ *
+ * @param mainStories - Stories from main repository
+ * @param worktreeStories - Map of story ID to story from worktrees
+ * @returns Merged array of stories with worktree versions prioritized
+ */
+function mergeStories(mainStories, worktreeStories) {
+    const merged = [];
+    for (const mainStory of mainStories) {
+        const storyId = mainStory.frontmatter.id;
+        // Check if worktree version exists
+        if (worktreeStories.has(storyId)) {
+            // Use worktree version (more up-to-date)
+            merged.push(worktreeStories.get(storyId));
+        }
+        else {
+            // Use main repo version
+            merged.push(mainStory);
+        }
+    }
+    return merged;
+}
 /**
  * Find all stories in the stories/ folder structure
  * Globs stories/*\u200B/story.md and returns all story objects
@@ -15,7 +95,7 @@ export function findAllStories(sdlcRoot) {
     if (!fs.existsSync(storiesFolder)) {
         return [];
     }
-    const stories = [];
+    const mainStories = [];
     const pattern = path.join(storiesFolder, '*', STORY_FILENAME);
     try {
         const storyPaths = glob.sync(pattern);
@@ -23,7 +103,7 @@ export function findAllStories(sdlcRoot) {
             try {
                 const canonicalPath = fs.realpathSync(storyPath);
                 const story = parseStory(canonicalPath);
-                stories.push({ ...story, path: canonicalPath });
+                mainStories.push({ ...story, path: canonicalPath });
             }
             catch (err) {
                 // Skip malformed stories or symlinks that can't be resolved
@@ -35,7 +115,10 @@ export function findAllStories(sdlcRoot) {
         // If glob fails, return empty array
         return [];
     }
-    return stories;
+    // Load stories from active worktrees
+    const worktreeStories = loadStoriesFromWorktrees(sdlcRoot);
+    // Merge: worktree version takes precedence
+    return mergeStories(mainStories, worktreeStories);
 }
 /**
  * Find stories by frontmatter status
@@ -370,4 +453,280 @@ export function getBoardStats(sdlcRoot) {
     }
     return stats;
 }
+/**
+ * Maximum allowed pattern length to prevent ReDoS attacks
+ */
+const MAX_PATTERN_LENGTH = 100;
+/**
+ * Check if a label matches a glob pattern.
+ * Supports wildcard (*) for pattern matching with proper regex escaping.
+ *
+ * @param label - The label to test
+ * @param pattern - The glob pattern (e.g., 'epic-*', '*-test')
+ * @returns true if label matches pattern
+ * @throws Error if pattern exceeds maximum length
+ *
+ * @example
+ * labelMatchesPattern('epic-ticketing', 'epic-*') // true
+ * labelMatchesPattern('sprint-2024-q1', 'epic-*') // false
+ * labelMatchesPattern('test.label', 'test.label') // true (special chars escaped)
+ */
+export function labelMatchesPattern(label, pattern) {
+    // Security: Prevent ReDoS by limiting pattern length
+    if (pattern.length > MAX_PATTERN_LENGTH) {
+        throw new Error(`Pattern exceeds maximum length of ${MAX_PATTERN_LENGTH} characters`);
+    }
+    // Handle empty pattern edge case
+    if (pattern === '') {
+        return label === '';
+    }
+    // Escape special regex characters except *
+    // Characters that need escaping: . + ? ^ $ { } ( ) | [ ] \
+    const escapedPattern = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+    // Convert glob wildcard (*) to regex (.*)
+    const regexPattern = escapedPattern.replace(/\*/g, '.*');
+    // Create anchored regex (exact match from start to end)
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(label);
+}
+/**
+ * Find stories by exact label match.
+ * Returns stories sorted by priority ascending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param label - Exact label to match
+ * @returns Array of stories with the specified label
+ *
+ * @example
+ * findStoriesByLabel(sdlcRoot, 'epic-ticketing')
+ */
+export function findStoriesByLabel(sdlcRoot, label) {
+    const allStories = findAllStories(sdlcRoot);
+    return allStories
+        .filter(story => story.frontmatter.labels.includes(label))
+        .sort((a, b) => {
+        // Sort by priority ascending
+        if (a.frontmatter.priority !== b.frontmatter.priority) {
+            return a.frontmatter.priority - b.frontmatter.priority;
+        }
+        // Tiebreaker: sort by creation date
+        return a.frontmatter.created.localeCompare(b.frontmatter.created);
+    });
+}
+/**
+ * Find stories by multiple labels with AND/OR logic.
+ * Returns stories sorted by priority ascending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param labels - Array of labels to match
+ * @param mode - 'all' requires all labels (AND), 'any' requires at least one (OR)
+ * @returns Array of matching stories
+ *
+ * @example
+ * // Stories with BOTH epic-ticketing AND team-backend
+ * findStoriesByLabels(sdlcRoot, ['epic-ticketing', 'team-backend'], 'all')
+ *
+ * // Stories with EITHER epic-ticketing OR epic-auth
+ * findStoriesByLabels(sdlcRoot, ['epic-ticketing', 'epic-auth'], 'any')
+ */
+export function findStoriesByLabels(sdlcRoot, labels, mode) {
+    // Return empty array for empty labels input
+    if (labels.length === 0) {
+        return [];
+    }
+    const allStories = findAllStories(sdlcRoot);
+    const filtered = allStories.filter(story => {
+        if (mode === 'all') {
+            // All labels must be present (AND logic)
+            return labels.every(label => story.frontmatter.labels.includes(label));
+        }
+        else {
+            // At least one label must be present (OR logic)
+            return labels.some(label => story.frontmatter.labels.includes(label));
+        }
+    });
+    return filtered.sort((a, b) => {
+        // Sort by priority ascending
+        if (a.frontmatter.priority !== b.frontmatter.priority) {
+            return a.frontmatter.priority - b.frontmatter.priority;
+        }
+        // Tiebreaker: sort by creation date
+        return a.frontmatter.created.localeCompare(b.frontmatter.created);
+    });
+}
+/**
+ * Find stories by glob pattern matching on labels.
+ * Returns deduplicated stories sorted by priority ascending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param pattern - Glob pattern (e.g., 'epic-*', '*-test', 'team-*-backend')
+ * @returns Array of stories with at least one matching label
+ *
+ * @example
+ * findStoriesByPattern(sdlcRoot, 'epic-*') // All stories with epic-* labels
+ * findStoriesByPattern(sdlcRoot, '*-test') // All stories with *-test labels
+ */
+export function findStoriesByPattern(sdlcRoot, pattern) {
+    // Return empty array for empty pattern
+    if (pattern === '') {
+        return [];
+    }
+    const allStories = findAllStories(sdlcRoot);
+    const filtered = allStories.filter(story => {
+        // Check if any label matches the pattern
+        return story.frontmatter.labels.some(label => labelMatchesPattern(label, pattern));
+    });
+    // Deduplicate by story ID (in case multiple labels match)
+    const seen = new Set();
+    const deduplicated = filtered.filter(story => {
+        if (seen.has(story.frontmatter.id)) {
+            return false;
+        }
+        seen.add(story.frontmatter.id);
+        return true;
+    });
+    return deduplicated.sort((a, b) => {
+        // Sort by priority ascending
+        if (a.frontmatter.priority !== b.frontmatter.priority) {
+            return a.frontmatter.priority - b.frontmatter.priority;
+        }
+        // Tiebreaker: sort by creation date
+        return a.frontmatter.created.localeCompare(b.frontmatter.created);
+    });
+}
+/**
+ * Get all unique labels across all stories.
+ * Returns labels sorted alphabetically.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @returns Sorted array of unique labels
+ *
+ * @example
+ * getUniqueLabels(sdlcRoot) // ['epic-auth', 'epic-ticketing', 'team-backend', ...]
+ */
+export function getUniqueLabels(sdlcRoot) {
+    const allStories = findAllStories(sdlcRoot);
+    const labelsSet = new Set();
+    for (const story of allStories) {
+        for (const label of story.frontmatter.labels) {
+            labelsSet.add(label);
+        }
+    }
+    return Array.from(labelsSet).sort();
+}
+/**
+ * Get grouping summaries for a specific dimension.
+ * Returns groupings sorted by story count descending.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param dimension - Grouping dimension ('thematic', 'temporal', 'structural')
+ * @returns Array of grouping summaries with story counts and status breakdowns
+ *
+ * @example
+ * getGroupings(sdlcRoot, 'thematic')
+ * // [
+ * //   { id: 'ticketing', label: 'epic-ticketing', dimension: 'thematic',
+ * //     storyCount: 5, statusBreakdown: { backlog: 2, ready: 1, ... } },
+ * //   ...
+ * // ]
+ */
+export function getGroupings(sdlcRoot, dimension) {
+    // Find the default configuration for this dimension
+    const config = DEFAULT_GROUPINGS.find(g => g.dimension === dimension);
+    if (!config) {
+        return [];
+    }
+    const allStories = findAllStories(sdlcRoot);
+    const prefix = config.prefix;
+    // Collect all labels matching this dimension's prefix
+    const groupingMap = new Map();
+    for (const story of allStories) {
+        const matchingLabels = story.frontmatter.labels.filter(label => label.startsWith(prefix));
+        // Check for cardinality violations (multiple labels when cardinality is 'single')
+        if (config.cardinality === 'single' && matchingLabels.length > 1) {
+            console.warn(`Story ${story.frontmatter.id} has multiple ${dimension} labels (${matchingLabels.join(', ')}) ` +
+                `but cardinality is 'single'. Consider using only one ${prefix}* label per story.`);
+        }
+        for (const label of matchingLabels) {
+            if (!groupingMap.has(label)) {
+                groupingMap.set(label, {
+                    label,
+                    stories: [],
+                });
+            }
+            groupingMap.get(label).stories.push(story);
+        }
+    }
+    // Convert to GroupingSummary array
+    const summaries = [];
+    for (const [label, data] of groupingMap.entries()) {
+        // Extract ID by removing prefix
+        const id = label.substring(prefix.length);
+        // Calculate status breakdown
+        const statusBreakdown = {
+            backlog: 0,
+            ready: 0,
+            'in-progress': 0,
+            done: 0,
+            blocked: 0,
+        };
+        for (const story of data.stories) {
+            statusBreakdown[story.frontmatter.status]++;
+        }
+        summaries.push({
+            id,
+            label,
+            dimension,
+            storyCount: data.stories.length,
+            statusBreakdown,
+        });
+    }
+    // Sort by story count descending
+    return summaries.sort((a, b) => b.storyCount - a.storyCount);
+}
+/**
+ * Find stories by epic label (convenience wrapper).
+ * Queries for stories with 'epic-{epicId}' label.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param epicId - Epic identifier (without 'epic-' prefix)
+ * @returns Array of stories with the specified epic label
+ *
+ * @example
+ * findStoriesByEpic(sdlcRoot, 'ticketing-integration')
+ * // Returns stories with label 'epic-ticketing-integration'
+ */
+export function findStoriesByEpic(sdlcRoot, epicId) {
+    return findStoriesByPattern(sdlcRoot, `epic-${epicId}`);
+}
+/**
+ * Find stories by sprint label (convenience wrapper).
+ * Queries for stories with 'sprint-{sprintId}' label.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param sprintId - Sprint identifier (without 'sprint-' prefix)
+ * @returns Array of stories with the specified sprint label
+ *
+ * @example
+ * findStoriesBySprint(sdlcRoot, '2024-q1')
+ * // Returns stories with label 'sprint-2024-q1'
+ */
+export function findStoriesBySprint(sdlcRoot, sprintId) {
+    return findStoriesByPattern(sdlcRoot, `sprint-${sprintId}`);
+}
+/**
+ * Find stories by team label (convenience wrapper).
+ * Queries for stories with 'team-{teamId}' label.
+ *
+ * @param sdlcRoot - Path to .ai-sdlc folder
+ * @param teamId - Team identifier (without 'team-' prefix)
+ * @returns Array of stories with the specified team label
+ *
+ * @example
+ * findStoriesByTeam(sdlcRoot, 'backend')
+ * // Returns stories with label 'team-backend'
+ */
+export function findStoriesByTeam(sdlcRoot, teamId) {
+    return findStoriesByPattern(sdlcRoot, `team-${teamId}`);
+}
 //# sourceMappingURL=kanban.js.map