@ttfw/envoi 1.0.0

package/dist/lib/git.js

@@ -0,0 +1,355 @@
+/**
+ * Git helper functions for preflight checks and diff tracking.
+ *
+ * Uses execSync for git operations to ensure synchronous, blocking behavior.
+ */
+import { execSync } from 'node:child_process';
+import micromatch from 'micromatch';
+/**
+ * Checks if the current directory is inside a git repository.
+ *
+ * @returns true if in a git repo, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (!isGitRepo()) {
+ *   console.error('Not in a git repository');
+ * }
+ * ```
+ */
+export function isGitRepo() {
+    try {
+        execSync('git rev-parse --is-inside-work-tree', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks if the git worktree is clean (no uncommitted tracked changes
+ * AND no untracked files).
+ *
+ * A clean worktree means:
+ * - No staged changes
+ * - No unstaged changes to tracked files
+ * - No untracked files
+ *
+ * @returns true if worktree is clean, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (!isWorktreeClean()) {
+ *   console.error('Worktree has uncommitted changes');
+ * }
+ * ```
+ */
+export function isWorktreeClean() {
+    try {
+        // git status --porcelain returns empty if nothing to report
+        // (no staged, unstaged, or untracked files)
+        const status = execSync('git status --porcelain', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return status.trim() === '';
+    }
+    catch {
+        // If git status fails, assume not clean
+        return false;
+    }
+}
+/**
+ * Parses git status porcelain output and filters files based on exclusion globs.
+ *
+ * This is a pure function that can be easily tested.
+ *
+ * @param statusOutput - Raw output from `git status --porcelain`
+ * @param excludeGlobs - Glob patterns for files to exclude from the dirty check
+ * @returns Object with `clean` (boolean), `dirtyFiles`, and `excludedFiles`
+ */
+export function parseGitStatusWithExclusions(statusOutput, excludeGlobs) {
+    // Only trim trailing whitespace to preserve leading space in status format
+    const trimmed = statusOutput.trimEnd();
+    if (trimmed === '') {
+        return { clean: true, dirtyFiles: [], excludedFiles: [] };
+    }
+    // Parse git status output to get file paths
+    // Format: XY filename (X=staged, Y=unstaged, ?? for untracked)
+    // XY are positions 0-1, space at position 2, path starts at position 3
+    const allFiles = trimmed
+        .split('\n')
+        .filter((line) => line.length > 0)
+        .map((line) => {
+        // Git status porcelain format: XY PATH or XY ORIG -> PATH for renames
+        // XY is always 2 chars, then a space, then the path
+        // But some entries like copies/renames have different formats
+        // Handle renamed/copied files: "R  old -> new" or "C  old -> new"
+        const rawPath = line.slice(3); // Use slice instead of substring for clarity
+        if (rawPath.includes(' -> ')) {
+            return rawPath.split(' -> ')[1];
+        }
+        return rawPath;
+    });
+    // Separate excluded vs non-excluded files
+    const excludedFiles = [];
+    const dirtyFiles = [];
+    for (const file of allFiles) {
+        if (excludeGlobs.length > 0 && micromatch.isMatch(file, excludeGlobs)) {
+            excludedFiles.push(file);
+        }
+        else {
+            dirtyFiles.push(file);
+        }
+    }
+    return {
+        clean: dirtyFiles.length === 0,
+        dirtyFiles,
+        excludedFiles,
+    };
+}
+/**
+ * Checks if the git worktree is clean, excluding files matching specified globs.
+ *
+ * This is useful for ignoring runner-owned files (like REPORT.json, STATE.json)
+ * that are expected to change every tick.
+ *
+ * @param excludeGlobs - Glob patterns for files to exclude from the dirty check
+ * @returns Object with `clean` (boolean) and `dirtyFiles` (non-excluded dirty files)
+ *
+ * @example
+ * ```typescript
+ * const result = isWorktreeCleanExcluding(['envoi/**', 'pilot/**']);
+ * if (!result.clean) {
+ *   console.error('Dirty files:', result.dirtyFiles);
+ * }
+ * ```
+ */
+export function isWorktreeCleanExcluding(excludeGlobs) {
+    try {
+        const status = execSync('git status --porcelain', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return parseGitStatusWithExclusions(status, excludeGlobs);
+    }
+    catch {
+        // If git status fails, assume not clean
+        return { clean: false, dirtyFiles: ['<git status failed>'], excludedFiles: [] };
+    }
+}
+/**
+ * Gets the current HEAD commit SHA.
+ *
+ * @returns The full 40-character SHA of HEAD
+ * @throws {Error} If not in a git repo or HEAD doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const sha = getHeadCommit();
+ * console.log(`Current commit: ${sha}`);
+ * ```
+ */
+export function getHeadCommit() {
+    try {
+        const sha = execSync('git rev-parse HEAD', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return sha.trim();
+    }
+    catch (error) {
+        throw new Error(`Failed to get HEAD commit: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Gets the list of files that have changed since a base commit.
+ *
+ * Returns both modified and added files in the diff.
+ *
+ * @param base - The base commit SHA to diff against
+ * @returns Array of file paths that have changed
+ * @throws {Error} If the diff operation fails
+ *
+ * @example
+ * ```typescript
+ * const changedFiles = getDiffFiles('abc123');
+ * console.log(`${changedFiles.length} files changed`);
+ * ```
+ */
+export function getDiffFiles(base) {
+    try {
+        const output = execSync(`git diff --name-only ${base}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return output
+            .trim()
+            .split('\n')
+            .filter((line) => line.length > 0);
+    }
+    catch (error) {
+        throw new Error(`Failed to get diff files from ${base}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Gets the list of untracked files in the repository.
+ *
+ * @returns Array of untracked file paths
+ *
+ * @example
+ * ```typescript
+ * const untracked = getUntrackedFiles();
+ * if (untracked.length > 0) {
+ *   console.log(`Found ${untracked.length} untracked files`);
+ * }
+ * ```
+ */
+export function getUntrackedFiles() {
+    try {
+        // -u shows untracked files, --porcelain gives machine-readable output
+        // Untracked files have ?? prefix
+        const output = execSync('git status --porcelain', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return output
+            .trim()
+            .split('\n')
+            .filter((line) => line.startsWith('??'))
+            .map((line) => line.substring(3)); // Remove "?? " prefix
+    }
+    catch {
+        // If git status fails, return empty array
+        return [];
+    }
+}
+/**
+ * Gets the current git branch name.
+ *
+ * @returns The current branch name
+ * @throws {Error} If not in a git repo or branch cannot be determined
+ *
+ * @example
+ * ```typescript
+ * const branch = getCurrentBranch();
+ * console.log(`Current branch: ${branch}`);
+ * ```
+ */
+export function getCurrentBranch() {
+    try {
+        const branch = execSync('git branch --show-current', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return branch.trim();
+    }
+    catch (error) {
+        throw new Error(`Failed to get current branch: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Gets the top-level directory of the git repository.
+ *
+ * @returns The absolute path to the git repository root, or null if not in a git repo
+ *
+ * @example
+ * ```typescript
+ * const root = getGitTopLevel();
+ * if (root) {
+ *   console.log(`Git root: ${root}`);
+ * }
+ * ```
+ */
+export function getGitTopLevel() {
+    try {
+        const topLevel = execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return topLevel.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Stashes pilot/ directory files to prevent merge conflicts.
+ *
+ * Creates a stash containing only files in the pilot/ directory.
+ * This allows safe merging without losing pilot state.
+ *
+ * @returns The stash reference (e.g., "stash@{0}")
+ * @throws {Error} If the stash operation fails
+ *
+ * @example
+ * ```typescript
+ * const stashRef = stashPilotFiles();
+ * // Perform merge...
+ * popPilotStash(stashRef);
+ * ```
+ */
+export function stashPilotFiles() {
+    try {
+        // Stash only pilot/ directory files
+        // --keep-index keeps staged changes, but we want to stash everything in pilot/
+        // Using git stash push with pathspec to stash only pilot/ files
+        const output = execSync('git stash push -m "envoi: auto-stash pilot files" -- pilot/', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Extract stash reference from output
+        // Output format: "Saved working directory and index state On <branch>: <message>"
+        // We need to get the stash ref, which is typically "stash@{0}" for the most recent stash
+        const stashRef = execSync('git rev-parse --short stash@{0}', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // Return the full stash reference
+        return 'stash@{0}';
+    }
+    catch (error) {
+        // If stash push fails (e.g., no changes to stash), check if stash exists
+        try {
+            // Try to get the most recent stash
+            execSync('git rev-parse --verify stash@{0} > /dev/null 2>&1', {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return 'stash@{0}';
+        }
+        catch {
+            throw new Error(`Failed to stash pilot files: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+/**
+ * Pops a previously created stash to restore pilot files.
+ *
+ * Restores the stashed pilot/ directory files back to the working tree.
+ *
+ * @param stashRef - The stash reference returned by stashPilotFiles (e.g., "stash@{0}")
+ * @throws {Error} If the stash pop operation fails
+ *
+ * @example
+ * ```typescript
+ * const stashRef = stashPilotFiles();
+ * // Perform merge...
+ * popPilotStash(stashRef);
+ * ```
+ */
+export function popPilotStash(stashRef) {
+    try {
+        execSync(`git stash pop ${stashRef}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to pop pilot stash ${stashRef}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC;QACH,QAAQ,CAAC,qCAAqC,EAAE;YAC9C,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,4DAA4D;QAC5D,4CAA4C;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE;YAChD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAC1C,YAAoB,EACpB,YAAsB;IAEtB,2EAA2E;IAC3E,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC;IACvC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IAC5D,CAAC;IAED,4CAA4C;IAC5C,+DAA+D;IAC/D,uEAAuE;IACvE,MAAM,QAAQ,GAAG,OAAO;SACrB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,sEAAsE;QACtE,oDAAoD;QACpD,8DAA8D;QAC9D,kEAAkE;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,6CAA6C;QAC5E,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,0CAA0C;IAC1C,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;YACtE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAC9B,UAAU;QACV,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE;YAChD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,OAAO,4BAA4B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;QACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,qBAAqB,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IAClF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,oBAAoB,EAAE;YACzC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,IAAI,EAAE,EAAE;YACtD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnG,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,sEAAsE;QACtE,iCAAiC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE;YAChD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;aACvC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YACnD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC1F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACzD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,oCAAoC;QACpC,+EAA+E;QAC/E,gEAAgE;QAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,6DAA6D,EAAE;YACrF,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,sCAAsC;QACtC,kFAAkF;QAClF,yFAAyF;QACzF,MAAM,QAAQ,GAAG,QAAQ,CAAC,iCAAiC,EAAE;YAC3D,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,kCAAkC;QAClC,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,IAAI,CAAC;YACH,mCAAmC;YACnC,QAAQ,CAAC,mDAAmD,EAAE;gBAC5D,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YACH,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,IAAI,CAAC;QACH,QAAQ,CAAC,iBAAiB,QAAQ,EAAE,EAAE;YACpC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/git_branching.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Git branching helper functions for runner-owned branch management.
+ *
+ * Uses execSync for git operations to ensure synchronous, blocking behavior.
+ * All git commands use argv-only (no shell strings) for security.
+ */
+import type { GitBranchingConfig } from '../types/config.js';
+/**
+ * Result of branch creation/switch operation.
+ */
+export interface BranchResult {
+    /** Whether the operation succeeded */
+    ok: boolean;
+    /** The branch name that was created/switched to */
+    branchName: string;
+    /** Error message if operation failed */
+    error?: string;
+    /** Whether the branch already existed */
+    existed: boolean;
+}
+/**
+ * Parameters for branch template expansion.
+ */
+export interface BranchTemplateParams {
+    task_id?: string;
+    milestone_id?: string;
+    run_id?: string;
+    tick_count?: number;
+    seq?: number;
+    batch_index?: number;
+    YYYYMMDD?: string;
+}
+/**
+ * Expands a branch name template with placeholders.
+ *
+ * Supported placeholders (both {{...}} and {...} styles):
+ * - {{task_id}} or {task_id} - Task ID
+ * - {{milestone_id}} or {milestone_id} - Milestone ID
+ * - {{run_id}} or {run_id} - Run ID
+ * - {{tick_count}} or {tick_count} - Tick count (1-based)
+ * - {{seq}} or {seq} or {{batch_index}} or {batch_index} - Sequence/batch index (0-based)
+ * - {{YYYYMMDD}} or {YYYYMMDD} - Date in YYYYMMDD format
+ *
+ * @param template - Template string with placeholders
+ * @param params - Parameters to substitute
+ * @returns Expanded branch name
+ */
+export declare function expandBranchTemplate(template: string, params: BranchTemplateParams): string;
+/**
+ * Ensures a branch exists and HEAD is on it (per_tick mode).
+ *
+ * For per_tick mode, creates/switches to a branch based on the template.
+ * If the branch already exists, switches to it (idempotent).
+ * If there's a collision, appends a numeric suffix.
+ *
+ * @param config - Git branching configuration
+ * @param params - Parameters for template expansion
+ * @returns BranchResult indicating success or failure
+ */
+export declare function ensureBranchPerTick(config: GitBranchingConfig, params: BranchTemplateParams): BranchResult;
+/**
+ * Ensures a branch exists and HEAD is on it (per_n_tasks mode).
+ *
+ * For per_n_tasks mode, creates/switches to a branch based on the template,
+ * grouping tasks into batches of n_tasks. The seq parameter represents
+ * the batch index (0-based).
+ *
+ * @param config - Git branching configuration
+ * @param params - Parameters for template expansion (must include seq for batch index)
+ * @returns BranchResult indicating success or failure
+ */
+export declare function ensureBranchPerNTasks(config: GitBranchingConfig, params: BranchTemplateParams): BranchResult;
+/**
+ * Ensures a branch exists and HEAD is on it (per_milestone mode).
+ *
+ * For per_milestone mode, creates/switches to a branch based on the template
+ * for the current milestone. All tasks in the same milestone use the same branch.
+ *
+ * @param config - Git branching configuration
+ * @param params - Parameters for template expansion (must include milestone_id)
+ * @returns BranchResult indicating success or failure
+ */
+export declare function ensureBranchPerMilestone(config: GitBranchingConfig, params: BranchTemplateParams): BranchResult;
+//# sourceMappingURL=git_branching.d.ts.map

package/dist/lib/git_branching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git_branching.d.ts","sourceRoot":"","sources":["../../src/lib/git_branching.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CAoCR;AAsJD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,YAAY,CA4Bd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,YAAY,CAkDd;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,YAAY,CAqCd"}