@chief-clancy/core 0.1.0

package/dist/shared/cache/cache.js

@@ -0,0 +1,25 @@
+/** Single-value process-lifetime cache. */
+export class Cached {
+    // eslint-disable-next-line functional/prefer-readonly-type -- intentionally mutable cache
+    #value;
+    get() {
+        return this.#value;
+    }
+    store(value) {
+        this.#value = value;
+    }
+}
+/** Key-value process-lifetime cache. */
+export class CachedMap {
+    #entries = new Map();
+    get(key) {
+        return this.#entries.get(key);
+    }
+    has(key) {
+        return this.#entries.has(key);
+    }
+    store(key, value) {
+        this.#entries.set(key, value);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/shared/cache/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/shared/cache/cache.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,OAAO,MAAM;IACjB,0FAA0F;IAC1F,MAAM,CAAgB;IAEtB,GAAG;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAQ;QACZ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;CACF;AAED,wCAAwC;AACxC,MAAM,OAAO,SAAS;IACX,QAAQ,GAAG,IAAI,GAAG,EAAQ,CAAC;IAEpC,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,GAAM,EAAE,KAAQ;QACpB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/shared/cache/index.d.ts

@@ -0,0 +1,2 @@
+export { Cached, CachedMap } from './cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/shared/cache/index.js

@@ -0,0 +1,2 @@
+export { Cached, CachedMap } from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/shared/env-parser/env-parser.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Parse a .env file content string into a key-value record.
+ *
+ * Handles single-quoted, double-quoted, and unquoted values.
+ * Ignores blank lines and lines starting with `#`. Does not process
+ * escape sequences (e.g. `\"` within quoted values). Duplicate keys
+ * resolve to the last value.
+ *
+ * @param content - The raw .env file content.
+ * @returns A record of environment variable key-value pairs.
+ *
+ * @example
+ * ```ts
+ * parseEnvContent('JIRA_BASE_URL=https://example.atlassian.net\nJIRA_USER=user@example.com');
+ * // { JIRA_BASE_URL: 'https://example.atlassian.net', JIRA_USER: 'user@example.com' }
+ * ```
+ */
+export declare const parseEnvContent: (content: string) => Record<string, string>;
+/** File system operations required by {@link loadClancyEnv}. */
+export type EnvFileSystem = {
+    /** @deprecated No longer called — kept for backward compatibility. */
+    readonly exists?: (path: string) => boolean;
+    readonly readFile: (path: string) => string;
+};
+/**
+ * Load environment variables from a `.clancy/.env` file.
+ *
+ * @param projectRoot - The root directory of the project containing `.clancy/`.
+ * @param fs - File system operations (injected for testability).
+ * @returns The parsed environment variables, or `undefined` if the file doesn't exist.
+ *
+ * @example
+ * ```ts
+ * import { readFileSync } from 'node:fs';
+ *
+ * const env = loadClancyEnv('/path/to/project', {
+ *   readFile: (p) => readFileSync(p, 'utf8'),
+ * });
+ * ```
+ */
+export declare const loadClancyEnv: (projectRoot: string, fs: EnvFileSystem) => Record<string, string> | undefined;
+//# sourceMappingURL=env-parser.d.ts.map

package/dist/shared/env-parser/env-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parser.d.ts","sourceRoot":"","sources":["../../../src/shared/env-parser/env-parser.ts"],"names":[],"mappings":"AA6DA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAKtE,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,GACxB,aAAa,MAAM,EACnB,IAAI,aAAa,KAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAQ3B,CAAC"}

package/dist/shared/env-parser/env-parser.js

@@ -0,0 +1,97 @@
+/**
+ * Clancy .env file parser.
+ *
+ * Reads key=value pairs from `.clancy/.env` files. Supports quoted values,
+ * comments, and blank lines. No third-party dependencies.
+ */
+import { join } from 'node:path';
+/**
+ * Strip surrounding quotes from a value string.
+ *
+ * Removes matched single or double quotes. Values shorter than 2 characters
+ * or with mismatched quotes are returned unchanged.
+ *
+ * @param value - The raw value string.
+ * @returns The value with surrounding quotes removed.
+ */
+const stripQuotes = (value) => {
+    if (value.length < 2)
+        return value;
+    const first = value[0];
+    const last = value[value.length - 1];
+    const isDoubleQuoted = first === '"' && last === '"';
+    const isSingleQuoted = first === "'" && last === "'";
+    if (isDoubleQuoted || isSingleQuoted) {
+        return value.slice(1, -1);
+    }
+    return value;
+};
+/**
+ * Parse a single .env line into a key-value tuple, or undefined if invalid.
+ *
+ * @param line - A single line from a .env file.
+ * @returns A [key, value] tuple, or undefined for blank/comment/invalid lines.
+ */
+const parseLine = (line) => {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#'))
+        return undefined;
+    const eqIndex = trimmed.indexOf('=');
+    if (eqIndex === -1)
+        return undefined;
+    const key = trimmed.slice(0, eqIndex).trim();
+    if (!key)
+        return undefined;
+    const value = stripQuotes(trimmed.slice(eqIndex + 1).trim());
+    return [key, value];
+};
+/** Type guard to filter out undefined entries from parsed lines. */
+const isDefined = (entry) => entry !== undefined;
+/**
+ * Parse a .env file content string into a key-value record.
+ *
+ * Handles single-quoted, double-quoted, and unquoted values.
+ * Ignores blank lines and lines starting with `#`. Does not process
+ * escape sequences (e.g. `\"` within quoted values). Duplicate keys
+ * resolve to the last value.
+ *
+ * @param content - The raw .env file content.
+ * @returns A record of environment variable key-value pairs.
+ *
+ * @example
+ * ```ts
+ * parseEnvContent('JIRA_BASE_URL=https://example.atlassian.net\nJIRA_USER=user@example.com');
+ * // { JIRA_BASE_URL: 'https://example.atlassian.net', JIRA_USER: 'user@example.com' }
+ * ```
+ */
+export const parseEnvContent = (content) => {
+    const lines = content.split('\n');
+    const entries = lines.map(parseLine).filter(isDefined);
+    return Object.fromEntries(entries);
+};
+/**
+ * Load environment variables from a `.clancy/.env` file.
+ *
+ * @param projectRoot - The root directory of the project containing `.clancy/`.
+ * @param fs - File system operations (injected for testability).
+ * @returns The parsed environment variables, or `undefined` if the file doesn't exist.
+ *
+ * @example
+ * ```ts
+ * import { readFileSync } from 'node:fs';
+ *
+ * const env = loadClancyEnv('/path/to/project', {
+ *   readFile: (p) => readFileSync(p, 'utf8'),
+ * });
+ * ```
+ */
+export const loadClancyEnv = (projectRoot, fs) => {
+    const envPath = join(projectRoot, '.clancy', '.env');
+    try {
+        return parseEnvContent(fs.readFile(envPath));
+    }
+    catch {
+        return undefined;
+    }
+};
+//# sourceMappingURL=env-parser.js.map

package/dist/shared/env-parser/env-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parser.js","sourceRoot":"","sources":["../../../src/shared/env-parser/env-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IAC5C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;IACrD,MAAM,cAAc,GAAG,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;IAErD,IAAI,cAAc,IAAI,cAAc,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAAC,IAAY,EAAyC,EAAE;IACxE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAE1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC,IAAI,OAAO,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAE7C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE7D,OAAO,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC;AAC/B,CAAC,CAAC;AAEF,oEAAoE;AACpE,MAAM,SAAS,GAAG,CAChB,KAA4C,EACR,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAA0B,EAAE;IACzE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEvD,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC;AASF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,WAAmB,EACnB,EAAiB,EACmB,EAAE;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC"}

package/dist/shared/env-parser/index.d.ts

@@ -0,0 +1,3 @@
+export type { EnvFileSystem } from './env-parser.js';
+export { loadClancyEnv, parseEnvContent } from './env-parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/env-parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/env-parser/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/shared/env-parser/index.js

@@ -0,0 +1,2 @@
+export { loadClancyEnv, parseEnvContent } from './env-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/env-parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/env-parser/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/shared/git-ops/git-ops.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Git operations — command wrappers with dependency-injected exec.
+ *
+ * Wraps common git commands used during the ticket lifecycle:
+ * branch creation, checkout, squash merge, push, and cleanup.
+ * The `exec` function is injected for testability — no direct
+ * `child_process` imports in this module.
+ */
+import type { RemoteInfo } from '../../types/index.js';
+/** Execute a git sub-command and return stdout. Throws on non-zero exit. */
+export type ExecGit = (args: readonly string[]) => string;
+/**
+ * Check whether a branch name is safe for use in git ref paths.
+ *
+ * Rejects path traversal (`..`) and absolute paths (`/` prefix) that
+ * could resolve to unexpected refs when interpolated into `refs/heads/`.
+ *
+ * @param branch - The branch name to validate.
+ * @returns `true` if the branch name is safe.
+ */
+export declare function isSafeBranchName(branch: string): boolean;
+/**
+ * Get the name of the currently checked-out branch.
+ *
+ * @param exec - Injected git executor.
+ * @returns The current branch name.
+ */
+export declare function currentBranch(exec: ExecGit): string;
+/**
+ * Check whether the working directory has uncommitted changes.
+ *
+ * @param exec - Injected git executor.
+ * @returns `true` if there are staged or unstaged changes.
+ */
+export declare function hasUncommittedChanges(exec: ExecGit): boolean;
+/**
+ * Check whether a local branch exists.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to check.
+ * @returns `true` if the branch exists locally.
+ */
+export declare function branchExists(exec: ExecGit, branch: string): boolean;
+/**
+ * Create a branch from a base branch if it doesn't already exist.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to create.
+ * @param baseBranch - The base branch to create from.
+ */
+export declare function ensureBranch(exec: ExecGit, branch: string, baseBranch: string): void;
+/**
+ * Check out a branch. Uses `-B` flag to force-create if needed.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to check out.
+ * @param force - If `true`, uses `-B` to force-create/reset the branch.
+ */
+export declare function checkout(exec: ExecGit, branch: string, force?: boolean): void;
+/**
+ * Squash merge a source branch into the currently checked-out branch
+ * and commit with the given message.
+ *
+ * @param exec - Injected git executor.
+ * @param sourceBranch - The branch to squash merge from.
+ * @param commitMessage - The commit message for the squash merge.
+ * @returns `true` if changes were committed, `false` if nothing to commit.
+ */
+export declare function squashMerge(exec: ExecGit, sourceBranch: string, commitMessage: string): boolean;
+/**
+ * Delete a local branch (force).
+ *
+ * Uses `-D` because squash merges leave the branch in an "unmerged"
+ * state from git's perspective, causing `-d` to fail.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to delete.
+ */
+export declare function deleteBranch(exec: ExecGit, branch: string): void;
+/**
+ * Check whether a branch exists on the remote (without fetching it).
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to check.
+ * @returns `true` if the branch exists on the remote.
+ */
+export declare function remoteBranchExists(exec: ExecGit, branch: string): boolean;
+/**
+ * Fetch a remote branch into a local branch of the same name.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to fetch from the remote.
+ * @returns `true` if the fetch succeeded, `false` if it doesn't exist.
+ */
+export declare function fetchRemoteBranch(exec: ExecGit, branch: string): boolean;
+/**
+ * Get the diff stat between the current branch and a target branch.
+ *
+ * Truncated to `maxLength` characters to avoid oversized prompts.
+ *
+ * @param exec - Injected git executor.
+ * @param targetBranch - The branch to diff against.
+ * @param maxLength - Maximum output length (default 8000).
+ * @returns The diff stat output, or `undefined` on failure.
+ */
+export declare function diffAgainstBranch(exec: ExecGit, targetBranch: string, maxLength?: number): string | undefined;
+/**
+ * Push a branch to the remote origin with upstream tracking.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to push.
+ * @returns `true` if the push succeeded, `false` on failure.
+ */
+export declare function pushBranch(exec: ExecGit, branch: string): boolean;
+/**
+ * Detect the remote origin and parse it into {@link RemoteInfo}.
+ *
+ * Shells out to `git remote get-url origin` via the injected exec.
+ * If `platformOverride` is a valid {@link GitPlatform}, it forces
+ * that platform instead of detecting from the hostname.
+ *
+ * @param exec - Injected git executor.
+ * @param platformOverride - Optional platform string (from `CLANCY_GIT_PLATFORM` env var).
+ * @returns Parsed remote info, or `{ host: 'none' }` when no remote exists.
+ */
+export declare function detectRemote(exec: ExecGit, platformOverride?: string): RemoteInfo;
+//# sourceMappingURL=git-ops.d.ts.map

package/dist/shared/git-ops/git-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/shared/git-ops/git-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIlE,4EAA4E;AAC5E,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAWD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAQ5D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CASnE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,IAAI,CAG3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAUT;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOzE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,MAAM,EACpB,SAAS,SAAO,GACf,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,gBAAgB,CAAC,EAAE,MAAM,GACxB,UAAU,CASZ"}

package/dist/shared/git-ops/git-ops.js

@@ -0,0 +1,225 @@
+import { parseRemote } from '../../shared/remote/index.js';
+/**
+ * Check whether a branch name is safe for use in git ref paths.
+ *
+ * Rejects path traversal (`..`) and absolute paths (`/` prefix) that
+ * could resolve to unexpected refs when interpolated into `refs/heads/`.
+ *
+ * @param branch - The branch name to validate.
+ * @returns `true` if the branch name is safe.
+ */
+export function isSafeBranchName(branch) {
+    return branch.length > 0 && !branch.includes('..') && !branch.startsWith('/');
+}
+/** Valid values for the `CLANCY_GIT_PLATFORM` env var override. Must stay in sync with {@link GitPlatform}. */
+const VALID_PLATFORMS = new Set([
+    'github',
+    'gitlab',
+    'bitbucket',
+    'bitbucket-server',
+    'azure',
+]);
+/**
+ * Get the name of the currently checked-out branch.
+ *
+ * @param exec - Injected git executor.
+ * @returns The current branch name.
+ */
+export function currentBranch(exec) {
+    return exec(['rev-parse', '--abbrev-ref', 'HEAD']).trim();
+}
+/**
+ * Check whether the working directory has uncommitted changes.
+ *
+ * @param exec - Injected git executor.
+ * @returns `true` if there are staged or unstaged changes.
+ */
+export function hasUncommittedChanges(exec) {
+    try {
+        exec(['diff', '--quiet']);
+        exec(['diff', '--cached', '--quiet']);
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Check whether a local branch exists.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to check.
+ * @returns `true` if the branch exists locally.
+ */
+export function branchExists(exec, branch) {
+    if (!isSafeBranchName(branch))
+        return false;
+    try {
+        exec(['show-ref', '--verify', '--quiet', `refs/heads/${branch}`]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a branch from a base branch if it doesn't already exist.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to create.
+ * @param baseBranch - The base branch to create from.
+ */
+export function ensureBranch(exec, branch, baseBranch) {
+    if (!branchExists(exec, branch)) {
+        exec(['checkout', '-b', branch, baseBranch]);
+    }
+}
+/**
+ * Check out a branch. Uses `-B` flag to force-create if needed.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to check out.
+ * @param force - If `true`, uses `-B` to force-create/reset the branch.
+ */
+export function checkout(exec, branch, force = false) {
+    const flag = force ? ['-B'] : [];
+    exec(['checkout', ...flag, branch]);
+}
+/**
+ * Squash merge a source branch into the currently checked-out branch
+ * and commit with the given message.
+ *
+ * @param exec - Injected git executor.
+ * @param sourceBranch - The branch to squash merge from.
+ * @param commitMessage - The commit message for the squash merge.
+ * @returns `true` if changes were committed, `false` if nothing to commit.
+ */
+export function squashMerge(exec, sourceBranch, commitMessage) {
+    exec(['merge', '--squash', sourceBranch]);
+    try {
+        exec(['diff', '--cached', '--quiet']);
+        return false;
+    }
+    catch {
+        exec(['commit', '-m', commitMessage]);
+        return true;
+    }
+}
+/**
+ * Delete a local branch (force).
+ *
+ * Uses `-D` because squash merges leave the branch in an "unmerged"
+ * state from git's perspective, causing `-d` to fail.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to delete.
+ */
+export function deleteBranch(exec, branch) {
+    exec(['branch', '-D', branch]);
+}
+/**
+ * Check whether a branch exists on the remote (without fetching it).
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to check.
+ * @returns `true` if the branch exists on the remote.
+ */
+export function remoteBranchExists(exec, branch) {
+    try {
+        const output = exec(['ls-remote', '--heads', 'origin', branch]).trim();
+        return output.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fetch a remote branch into a local branch of the same name.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to fetch from the remote.
+ * @returns `true` if the fetch succeeded, `false` if it doesn't exist.
+ */
+export function fetchRemoteBranch(exec, branch) {
+    try {
+        exec(['fetch', 'origin', `${branch}:${branch}`]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the diff stat between the current branch and a target branch.
+ *
+ * Truncated to `maxLength` characters to avoid oversized prompts.
+ *
+ * @param exec - Injected git executor.
+ * @param targetBranch - The branch to diff against.
+ * @param maxLength - Maximum output length (default 8000).
+ * @returns The diff stat output, or `undefined` on failure.
+ */
+export function diffAgainstBranch(exec, targetBranch, maxLength = 8000) {
+    try {
+        const output = exec(['diff', `${targetBranch}...HEAD`, '--stat']).trim();
+        if (!output)
+            return undefined;
+        if (output.length <= maxLength)
+            return output;
+        return output.slice(0, maxLength) + '\n... (truncated)';
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Push a branch to the remote origin with upstream tracking.
+ *
+ * @param exec - Injected git executor.
+ * @param branch - The branch name to push.
+ * @returns `true` if the push succeeded, `false` on failure.
+ */
+export function pushBranch(exec, branch) {
+    try {
+        exec(['push', '-u', 'origin', branch]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect the remote origin and parse it into {@link RemoteInfo}.
+ *
+ * Shells out to `git remote get-url origin` via the injected exec.
+ * If `platformOverride` is a valid {@link GitPlatform}, it forces
+ * that platform instead of detecting from the hostname.
+ *
+ * @param exec - Injected git executor.
+ * @param platformOverride - Optional platform string (from `CLANCY_GIT_PLATFORM` env var).
+ * @returns Parsed remote info, or `{ host: 'none' }` when no remote exists.
+ */
+export function detectRemote(exec, platformOverride) {
+    const rawUrl = safeExec(exec, ['remote', 'get-url', 'origin']);
+    if (!rawUrl)
+        return { host: 'none' };
+    const validOverride = isValidPlatform(platformOverride)
+        ? platformOverride
+        : undefined;
+    return parseRemote(rawUrl, validOverride);
+}
+/** Run exec and return trimmed stdout, or `undefined` on failure/empty. */
+function safeExec(exec, args) {
+    try {
+        const output = exec(args).trim();
+        return output || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Type guard: is the value a valid {@link GitPlatform} override? */
+function isValidPlatform(value) {
+    return value !== undefined && VALID_PLATFORMS.has(value);
+}
+//# sourceMappingURL=git-ops.js.map

package/dist/shared/git-ops/git-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.js","sourceRoot":"","sources":["../../../src/shared/git-ops/git-ops.ts"],"names":[],"mappings":"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"}

package/dist/shared/git-ops/index.d.ts

@@ -0,0 +1,3 @@
+export type { ExecGit } from './git-ops.js';
+export { branchExists, checkout, currentBranch, detectRemote, ensureBranch, fetchRemoteBranch, hasUncommittedChanges, pushBranch, remoteBranchExists, } from './git-ops.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/git-ops/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/git-ops/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/shared/git-ops/index.js

@@ -0,0 +1,2 @@
+export { branchExists, checkout, currentBranch, detectRemote, ensureBranch, fetchRemoteBranch, hasUncommittedChanges, pushBranch, remoteBranchExists, } from './git-ops.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/git-ops/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/git-ops/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/shared/git-token/git-token.d.ts

@@ -0,0 +1,18 @@
+import type { SharedEnv } from '../../schemas/env/env.js';
+import type { RemoteInfo } from '../../types/remote.js';
+/** Resolved git host credentials. */
+type GitCredentials = {
+    readonly token: string;
+    readonly username?: string;
+};
+/**
+ * Resolve a git host token from the board config's env.
+ *
+ * Switches on `remote.host` to extract the correct credential from the
+ * shared env vars (`GITHUB_TOKEN`, `GITLAB_TOKEN`, `BITBUCKET_*`, `AZDO_PAT`).
+ *
+ * @returns Credentials for the git platform, or `undefined` if none found.
+ */
+export declare function resolveGitToken(env: SharedEnv, remote: RemoteInfo): GitCredentials | undefined;
+export {};
+//# sourceMappingURL=git-token.d.ts.map

package/dist/shared/git-token/git-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-token.d.ts","sourceRoot":"","sources":["../../../src/shared/git-token/git-token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qCAAqC;AACrC,KAAK,cAAc,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAaF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,UAAU,GACjB,cAAc,GAAG,SAAS,CAS5B"}

package/dist/shared/git-token/git-token.js

@@ -0,0 +1,28 @@
+/** Map a git platform to its simple token env var. */
+function simpleToken(env, host) {
+    const tokenMap = {
+        github: env.GITHUB_TOKEN,
+        gitlab: env.GITLAB_TOKEN,
+        'bitbucket-server': env.BITBUCKET_TOKEN,
+        azure: env.AZDO_PAT,
+    };
+    return tokenMap[host];
+}
+/**
+ * Resolve a git host token from the board config's env.
+ *
+ * Switches on `remote.host` to extract the correct credential from the
+ * shared env vars (`GITHUB_TOKEN`, `GITLAB_TOKEN`, `BITBUCKET_*`, `AZDO_PAT`).
+ *
+ * @returns Credentials for the git platform, or `undefined` if none found.
+ */
+export function resolveGitToken(env, remote) {
+    if (remote.host === 'bitbucket') {
+        return env.BITBUCKET_USER && env.BITBUCKET_TOKEN
+            ? { token: env.BITBUCKET_TOKEN, username: env.BITBUCKET_USER }
+            : undefined;
+    }
+    const token = simpleToken(env, remote.host);
+    return token ? { token } : undefined;
+}
+//# sourceMappingURL=git-token.js.map

package/dist/shared/git-token/git-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-token.js","sourceRoot":"","sources":["../../../src/shared/git-token/git-token.ts"],"names":[],"mappings":"AASA,sDAAsD;AACtD,SAAS,WAAW,CAAC,GAAc,EAAE,IAAY;IAC/C,MAAM,QAAQ,GAAuC;QACnD,MAAM,EAAE,GAAG,CAAC,YAAY;QACxB,MAAM,EAAE,GAAG,CAAC,YAAY;QACxB,kBAAkB,EAAE,GAAG,CAAC,eAAe;QACvC,KAAK,EAAE,GAAG,CAAC,QAAQ;KACpB,CAAC;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAc,EACd,MAAkB;IAElB,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,eAAe;YAC9C,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,GAAG,CAAC,cAAc,EAAE;YAC9D,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC"}

package/dist/shared/git-token/index.d.ts

@@ -0,0 +1,2 @@
+export { resolveGitToken } from './git-token.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/git-token/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/git-token/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}