chief-clancy 0.2.0-beta.3 → 0.3.0

package/dist/scripts/shared/env-schema/env-schema.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Board detection from raw `.clancy/.env` variables.
+ *
+ * Validates env vars against Zod schemas and returns a typed
+ * discriminated union for the detected board provider.
+ */
+import type { BoardConfig } from '../../../schemas/env.js';
+export type { BoardConfig, GitHubEnv, JiraEnv, LinearEnv, SharedEnv, } from '../../../schemas/env.js';
+/**
+ * Detect which board is configured from raw env vars and return a typed config.
+ *
+ * Detection priority: Jira → GitHub → Linear (checked by presence of
+ * board-specific required keys). Returns the first match.
+ *
+ * @param raw - The raw key-value record from `.clancy/.env`.
+ * @returns A typed `BoardConfig` or an error string if no board is detected
+ *   or validation fails.
+ *
+ * @example
+ * ```ts
+ * const result = detectBoard({ GITHUB_TOKEN: 'ghp_xxx', GITHUB_REPO: 'acme/app' });
+ * if (typeof result === 'string') console.error(result);
+ * else console.log(result.provider); // 'github'
+ * ```
+ */
+export declare function detectBoard(raw: Record<string, string>): BoardConfig | string;
+//# sourceMappingURL=env-schema.d.ts.map

package/dist/scripts/shared/env-schema/env-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-schema.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/env-schema/env-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQpD,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,GAAG,MAAM,CAmC7E"}

package/dist/scripts/shared/env-schema/env-schema.js

@@ -0,0 +1,46 @@
+import { githubEnvSchema, jiraEnvSchema, linearEnvSchema, } from '../../../schemas/env.js';
+/**
+ * Detect which board is configured from raw env vars and return a typed config.
+ *
+ * Detection priority: Jira → GitHub → Linear (checked by presence of
+ * board-specific required keys). Returns the first match.
+ *
+ * @param raw - The raw key-value record from `.clancy/.env`.
+ * @returns A typed `BoardConfig` or an error string if no board is detected
+ *   or validation fails.
+ *
+ * @example
+ * ```ts
+ * const result = detectBoard({ GITHUB_TOKEN: 'ghp_xxx', GITHUB_REPO: 'acme/app' });
+ * if (typeof result === 'string') console.error(result);
+ * else console.log(result.provider); // 'github'
+ * ```
+ */
+export function detectBoard(raw) {
+    // Jira — check for JIRA_BASE_URL as the distinguishing key
+    if (raw.JIRA_BASE_URL) {
+        const parsed = jiraEnvSchema.safeParse(raw);
+        if (!parsed.success) {
+            return `✗ Jira env validation failed: ${parsed.error.message}`;
+        }
+        return { provider: 'jira', env: parsed.data };
+    }
+    // GitHub — check for GITHUB_TOKEN as the distinguishing key
+    if (raw.GITHUB_TOKEN) {
+        const parsed = githubEnvSchema.safeParse(raw);
+        if (!parsed.success) {
+            return `✗ GitHub env validation failed: ${parsed.error.message}`;
+        }
+        return { provider: 'github', env: parsed.data };
+    }
+    // Linear — check for LINEAR_API_KEY as the distinguishing key
+    if (raw.LINEAR_API_KEY) {
+        const parsed = linearEnvSchema.safeParse(raw);
+        if (!parsed.success) {
+            return `✗ Linear env validation failed: ${parsed.error.message}`;
+        }
+        return { provider: 'linear', env: parsed.data };
+    }
+    return '✗ No board detected — set Jira, GitHub, or Linear credentials in .clancy/.env';
+}
+//# sourceMappingURL=env-schema.js.map

package/dist/scripts/shared/env-schema/env-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-schema.js","sourceRoot":"","sources":["../../../../src/scripts/shared/env-schema/env-schema.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAW1B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,GAA2B;IACrD,2DAA2D;IAC3D,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,iCAAiC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACjE,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,4DAA4D;IAC5D,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,mCAAmC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnE,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,8DAA8D;IAC9D,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,mCAAmC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnE,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,+EAA+E,CAAC;AACzF,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * Get the name of the currently checked-out branch.
+ *
+ * @returns The current branch name.
+ */
+export declare function currentBranch(): string;
+/**
+ * Check whether the working directory has uncommitted changes.
+ *
+ * @returns `true` if there are staged or unstaged changes.
+ */
+export declare function hasUncommittedChanges(): boolean;
+/**
+ * Check whether a local branch exists.
+ *
+ * @param branch - The branch name to check.
+ * @returns `true` if the branch exists locally.
+ */
+export declare function branchExists(branch: string): boolean;
+/**
+ * Create a branch from a base branch if it doesn't already exist.
+ *
+ * @param branch - The branch name to create.
+ * @param baseBranch - The base branch to create from.
+ */
+export declare function ensureBranch(branch: string, baseBranch: string): void;
+/**
+ * Check out a branch. Uses `-B` flag to force-create if needed.
+ *
+ * @param branch - The branch name to check out.
+ * @param force - If `true`, uses `-B` to force-create/reset the branch.
+ */
+export declare function checkout(branch: string, force?: boolean): void;
+/**
+ * Squash merge a source branch into the currently checked-out branch
+ * and commit with the given message.
+ *
+ * @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 there was nothing to commit.
+ */
+export declare function squashMerge(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 branch - The branch name to delete.
+ */
+export declare function deleteBranch(branch: string): void;
+//# sourceMappingURL=git-ops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/git-ops/git-ops.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAQ/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAapD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,IAAI,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAUT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjD"}

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

@@ -0,0 +1,107 @@
+/**
+ * Git operations shared across board scripts.
+ *
+ * Wraps common git commands used during the ticket lifecycle:
+ * branch creation, checkout, squash merge, and cleanup.
+ */
+import { execFileSync } from 'node:child_process';
+/**
+ * Run a git command and return trimmed stdout.
+ *
+ * @param args - The git sub-command and its arguments.
+ * @returns The trimmed stdout output.
+ */
+function git(...args) {
+    return execFileSync('git', args, { encoding: 'utf8' }).trim();
+}
+/**
+ * Get the name of the currently checked-out branch.
+ *
+ * @returns The current branch name.
+ */
+export function currentBranch() {
+    return git('rev-parse', '--abbrev-ref', 'HEAD');
+}
+/**
+ * Check whether the working directory has uncommitted changes.
+ *
+ * @returns `true` if there are staged or unstaged changes.
+ */
+export function hasUncommittedChanges() {
+    try {
+        execFileSync('git', ['diff', '--quiet'], { stdio: 'ignore' });
+        execFileSync('git', ['diff', '--cached', '--quiet'], { stdio: 'ignore' });
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Check whether a local branch exists.
+ *
+ * @param branch - The branch name to check.
+ * @returns `true` if the branch exists locally.
+ */
+export function branchExists(branch) {
+    try {
+        execFileSync('git', ['show-ref', '--verify', '--quiet', `refs/heads/${branch}`], {
+            stdio: 'ignore',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a branch from a base branch if it doesn't already exist.
+ *
+ * @param branch - The branch name to create.
+ * @param baseBranch - The base branch to create from.
+ */
+export function ensureBranch(branch, baseBranch) {
+    if (!branchExists(branch)) {
+        git('checkout', '-b', branch, baseBranch);
+    }
+}
+/**
+ * Check out a branch. Uses `-B` flag to force-create if needed.
+ *
+ * @param branch - The branch name to check out.
+ * @param force - If `true`, uses `-B` to force-create/reset the branch.
+ */
+export function checkout(branch, force = false) {
+    git('checkout', ...(force ? ['-B'] : []), branch);
+}
+/**
+ * Squash merge a source branch into the currently checked-out branch
+ * and commit with the given message.
+ *
+ * @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 there was nothing to commit.
+ */
+export function squashMerge(sourceBranch, commitMessage) {
+    git('merge', '--squash', sourceBranch);
+    try {
+        execFileSync('git', ['diff', '--cached', '--quiet'], { stdio: 'ignore' });
+        return false; // nothing staged
+    }
+    catch {
+        execFileSync('git', ['commit', '-m', commitMessage], { encoding: 'utf8' });
+        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 branch - The branch name to delete.
+ */
+export function deleteBranch(branch) {
+    git('branch', '-D', branch);
+}
+//# sourceMappingURL=git-ops.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.js","sourceRoot":"","sources":["../../../../src/scripts/shared/git-ops/git-ops.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;GAKG;AACH,SAAS,GAAG,CAAC,GAAG,IAAc;IAC5B,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,GAAG,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9D,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,YAAY,CACV,KAAK,EACL,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,MAAM,EAAE,CAAC,EAC3D;YACE,KAAK,EAAE,QAAQ;SAChB,CACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAAkB;IAC7D,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAK,GAAG,KAAK;IACpD,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,YAAoB,EACpB,aAAqB;IAErB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAEvC,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,CAAC,iBAAiB;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/scripts/shared/http/http.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared HTTP helpers for board scripts.
+ *
+ * Provides a generic ping function and header builders to reduce
+ * boilerplate across Jira, GitHub, and Linear integrations.
+ */
+/** Standard error messages mapped to HTTP status codes. */
+type StatusErrorMap = Record<number, string>;
+/** Result from a ping or connectivity check. */
+export type PingResult = {
+    ok: boolean;
+    error?: string;
+};
+/**
+ * Ping an API endpoint and map common HTTP error codes to messages.
+ *
+ * Returns `{ ok: true }` on success, or `{ ok: false, error }` with
+ * a human-readable message on failure.
+ *
+ * @param url - The URL to ping.
+ * @param headers - HTTP headers to send.
+ * @param statusErrors - Map of HTTP status codes to error messages.
+ * @param networkError - Error message for network failures.
+ * @returns A ping result with `ok` and optional `error`.
+ *
+ * @example
+ * ```ts
+ * const result = await pingEndpoint(
+ *   'https://api.github.com/repos/owner/repo',
+ *   { Authorization: 'Bearer tok_xxx' },
+ *   { 401: '✗ Auth failed', 404: '✗ Not found' },
+ *   '✗ Could not reach GitHub',
+ * );
+ * ```
+ */
+export declare function pingEndpoint(url: string, headers: Record<string, string>, statusErrors: StatusErrorMap, networkError: string): Promise<PingResult>;
+/**
+ * Build standard GitHub API request headers.
+ *
+ * @param token - The GitHub personal access token.
+ * @returns Headers object for GitHub REST API requests.
+ */
+export declare function githubHeaders(token: string): Record<string, string>;
+/**
+ * Build standard Jira API request headers.
+ *
+ * @param auth - The Base64-encoded Basic auth string.
+ * @returns Headers object for Jira REST API requests.
+ */
+export declare function jiraHeaders(auth: string): Record<string, string>;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/scripts/shared/http/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/http/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2DAA2D;AAC3D,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,EAAE,cAAc,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMnE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKhE"}

package/dist/scripts/shared/http/http.js

@@ -0,0 +1,74 @@
+/**
+ * Shared HTTP helpers for board scripts.
+ *
+ * Provides a generic ping function and header builders to reduce
+ * boilerplate across Jira, GitHub, and Linear integrations.
+ */
+/**
+ * Ping an API endpoint and map common HTTP error codes to messages.
+ *
+ * Returns `{ ok: true }` on success, or `{ ok: false, error }` with
+ * a human-readable message on failure.
+ *
+ * @param url - The URL to ping.
+ * @param headers - HTTP headers to send.
+ * @param statusErrors - Map of HTTP status codes to error messages.
+ * @param networkError - Error message for network failures.
+ * @returns A ping result with `ok` and optional `error`.
+ *
+ * @example
+ * ```ts
+ * const result = await pingEndpoint(
+ *   'https://api.github.com/repos/owner/repo',
+ *   { Authorization: 'Bearer tok_xxx' },
+ *   { 401: '✗ Auth failed', 404: '✗ Not found' },
+ *   '✗ Could not reach GitHub',
+ * );
+ * ```
+ */
+export async function pingEndpoint(url, headers, statusErrors, networkError) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10_000);
+        const response = await fetch(url, {
+            headers,
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        if (response.ok)
+            return { ok: true };
+        const mapped = statusErrors[response.status];
+        if (mapped)
+            return { ok: false, error: mapped };
+        return { ok: false, error: `✗ HTTP ${response.status}` };
+    }
+    catch {
+        return { ok: false, error: networkError };
+    }
+}
+/**
+ * Build standard GitHub API request headers.
+ *
+ * @param token - The GitHub personal access token.
+ * @returns Headers object for GitHub REST API requests.
+ */
+export function githubHeaders(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        Accept: 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+    };
+}
+/**
+ * Build standard Jira API request headers.
+ *
+ * @param auth - The Base64-encoded Basic auth string.
+ * @returns Headers object for Jira REST API requests.
+ */
+export function jiraHeaders(auth) {
+    return {
+        Authorization: `Basic ${auth}`,
+        Accept: 'application/json',
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/scripts/shared/http/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/scripts/shared/http/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,OAA+B,EAC/B,YAA4B,EAC5B,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QAE7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO;YACP,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,IAAI,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAEhD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO;QACL,aAAa,EAAE,UAAU,KAAK,EAAE;QAChC,MAAM,EAAE,6BAA6B;QACrC,sBAAsB,EAAE,YAAY;KACrC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO;QACL,aAAa,EAAE,SAAS,IAAI,EAAE;QAC9B,MAAM,EAAE,kBAAkB;KAC3B,CAAC;AACJ,CAAC"}

package/dist/scripts/shared/notify/notify.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Webhook notification sender for Slack and Microsoft Teams.
+ *
+ * Sends completion notifications after a ticket is processed.
+ * Best-effort — never throws on failure.
+ */
+/**
+ * Detect whether a webhook URL is for Slack (vs Teams/other).
+ *
+ * @param url - The webhook URL to check.
+ * @returns `true` if the URL contains `hooks.slack.com`.
+ */
+export declare function isSlackWebhook(url: string): boolean;
+/**
+ * Build a Slack webhook payload.
+ *
+ * @param message - The notification message text.
+ * @returns The JSON payload string for a Slack incoming webhook.
+ */
+export declare function buildSlackPayload(message: string): string;
+/**
+ * Build a Microsoft Teams webhook payload using an adaptive card.
+ *
+ * @param message - The notification message text.
+ * @returns The JSON payload string for a Teams incoming webhook.
+ */
+export declare function buildTeamsPayload(message: string): string;
+/**
+ * Send a notification to a webhook URL.
+ *
+ * Automatically detects Slack vs Teams format based on the URL.
+ * Best-effort — logs a warning on failure but never throws.
+ *
+ * @param webhookUrl - The Slack or Teams webhook URL.
+ * @param message - The notification message to send.
+ *
+ * @example
+ * ```ts
+ * await sendNotification(
+ *   'https://hooks.slack.com/services/xxx/yyy/zzz',
+ *   '✓ Clancy completed [PROJ-123] Add login page',
+ * );
+ * ```
+ */
+export declare function sendNotification(webhookUrl: string, message: string): Promise<void>;
+//# sourceMappingURL=notify.d.ts.map

package/dist/scripts/shared/notify/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/notify/notify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/scripts/shared/notify/notify.js

@@ -0,0 +1,88 @@
+/**
+ * Webhook notification sender for Slack and Microsoft Teams.
+ *
+ * Sends completion notifications after a ticket is processed.
+ * Best-effort — never throws on failure.
+ */
+/**
+ * Detect whether a webhook URL is for Slack (vs Teams/other).
+ *
+ * @param url - The webhook URL to check.
+ * @returns `true` if the URL contains `hooks.slack.com`.
+ */
+export function isSlackWebhook(url) {
+    return url.includes('hooks.slack.com');
+}
+/**
+ * Build a Slack webhook payload.
+ *
+ * @param message - The notification message text.
+ * @returns The JSON payload string for a Slack incoming webhook.
+ */
+export function buildSlackPayload(message) {
+    return JSON.stringify({ text: message });
+}
+/**
+ * Build a Microsoft Teams webhook payload using an adaptive card.
+ *
+ * @param message - The notification message text.
+ * @returns The JSON payload string for a Teams incoming webhook.
+ */
+export function buildTeamsPayload(message) {
+    return JSON.stringify({
+        type: 'message',
+        attachments: [
+            {
+                contentType: 'application/vnd.microsoft.card.adaptive',
+                content: {
+                    $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+                    type: 'AdaptiveCard',
+                    version: '1.4',
+                    body: [
+                        {
+                            type: 'TextBlock',
+                            text: message,
+                            wrap: true,
+                        },
+                    ],
+                },
+            },
+        ],
+    });
+}
+/**
+ * Send a notification to a webhook URL.
+ *
+ * Automatically detects Slack vs Teams format based on the URL.
+ * Best-effort — logs a warning on failure but never throws.
+ *
+ * @param webhookUrl - The Slack or Teams webhook URL.
+ * @param message - The notification message to send.
+ *
+ * @example
+ * ```ts
+ * await sendNotification(
+ *   'https://hooks.slack.com/services/xxx/yyy/zzz',
+ *   '✓ Clancy completed [PROJ-123] Add login page',
+ * );
+ * ```
+ */
+export async function sendNotification(webhookUrl, message) {
+    const payload = isSlackWebhook(webhookUrl)
+        ? buildSlackPayload(message)
+        : buildTeamsPayload(message);
+    try {
+        const response = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: payload,
+        });
+        if (!response.ok) {
+            console.warn(`⚠ Notification failed: HTTP ${response.status}`);
+        }
+    }
+    catch {
+        console.warn('⚠ Notification failed: could not reach webhook');
+    }
+}
+//# sourceMappingURL=notify.js.map

package/dist/scripts/shared/notify/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../../../src/scripts/shared/notify/notify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;YACX;gBACE,WAAW,EAAE,yCAAyC;gBACtD,OAAO,EAAE;oBACP,OAAO,EAAE,oDAAoD;oBAC7D,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE;wBACJ;4BACE,IAAI,EAAE,WAAW;4BACjB,IAAI,EAAE,OAAO;4BACb,IAAI,EAAE,IAAI;yBACX;qBACF;iBACF;aACF;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,OAAe;IAEf,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC;QACxC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC;QAC5B,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,+BAA+B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/scripts/shared/preflight/preflight.d.ts

@@ -0,0 +1,40 @@
+type PreflightResult = {
+    ok: boolean;
+    error?: string;
+    warning?: string;
+    env?: Record<string, string>;
+};
+/**
+ * Check whether a binary is available on the system PATH.
+ *
+ * @param name - The binary name to check (e.g., `'git'`, `'curl'`).
+ * @returns `true` if the binary is found.
+ */
+export declare function binaryExists(name: string): boolean;
+/**
+ * Check whether the current directory is inside a git repository.
+ *
+ * @returns `true` if a `.git` directory is found.
+ */
+export declare function isGitRepo(): boolean;
+/**
+ * Run all preflight checks common to every board script.
+ *
+ * Checks for required binaries (`claude`, `git`), the `.clancy/.env` file,
+ * git repository state, and uncommitted changes.
+ *
+ * @param projectRoot - The root directory of the project.
+ * @returns A result object with `ok`, optional `error`/`warning`, and parsed `env`.
+ *
+ * @example
+ * ```ts
+ * const result = runPreflight('/path/to/project');
+ * if (!result.ok) {
+ *   console.error(result.error);
+ *   process.exit(0);
+ * }
+ * ```
+ */
+export declare function runPreflight(projectRoot: string): PreflightResult;
+export {};
+//# sourceMappingURL=preflight.d.ts.map

package/dist/scripts/shared/preflight/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/preflight/preflight.ts"],"names":[],"mappings":"AAWA,KAAK,eAAe,GAAG;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAOnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAgCjE"}

package/dist/scripts/shared/preflight/preflight.js

@@ -0,0 +1,84 @@
+/**
+ * Preflight checks shared across board scripts.
+ *
+ * Validates the environment before running a ticket:
+ * required binaries, .env file, git repository, and working directory state.
+ */
+import { execFileSync } from 'node:child_process';
+import { loadClancyEnv } from '../../../scripts/shared/env-parser/env-parser.js';
+import { hasUncommittedChanges } from '../../../scripts/shared/git-ops/git-ops.js';
+/**
+ * Check whether a binary is available on the system PATH.
+ *
+ * @param name - The binary name to check (e.g., `'git'`, `'curl'`).
+ * @returns `true` if the binary is found.
+ */
+export function binaryExists(name) {
+    try {
+        execFileSync('which', [name], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check whether the current directory is inside a git repository.
+ *
+ * @returns `true` if a `.git` directory is found.
+ */
+export function isGitRepo() {
+    try {
+        execFileSync('git', ['rev-parse', '--git-dir'], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run all preflight checks common to every board script.
+ *
+ * Checks for required binaries (`claude`, `git`), the `.clancy/.env` file,
+ * git repository state, and uncommitted changes.
+ *
+ * @param projectRoot - The root directory of the project.
+ * @returns A result object with `ok`, optional `error`/`warning`, and parsed `env`.
+ *
+ * @example
+ * ```ts
+ * const result = runPreflight('/path/to/project');
+ * if (!result.ok) {
+ *   console.error(result.error);
+ *   process.exit(0);
+ * }
+ * ```
+ */
+export function runPreflight(projectRoot) {
+    // Check required binaries
+    for (const bin of ['claude', 'git']) {
+        if (!binaryExists(bin)) {
+            return { ok: false, error: `✗ ${bin} is required but not found` };
+        }
+    }
+    // Check .env file
+    const env = loadClancyEnv(projectRoot);
+    if (!env) {
+        return {
+            ok: false,
+            error: '✗ .clancy/.env not found — run /clancy:init first',
+        };
+    }
+    // Check git repo
+    if (!isGitRepo()) {
+        return { ok: false, error: '✗ Not inside a git repository' };
+    }
+    // Warn about uncommitted changes
+    let warning;
+    if (hasUncommittedChanges()) {
+        warning =
+            '⚠ Working directory has uncommitted changes — they will be included in the branch';
+    }
+    return { ok: true, env, warning };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/scripts/shared/preflight/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../../src/scripts/shared/preflight/preflight.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAS5E;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,0BAA0B;IAC1B,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,4BAA4B,EAAE,CAAC;QACpE,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAEvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,mDAAmD;SAC3D,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC;IAC/D,CAAC;IAED,iCAAiC;IACjC,IAAI,OAA2B,CAAC;IAEhC,IAAI,qBAAqB,EAAE,EAAE,CAAC;QAC5B,OAAO;YACL,mFAAmF,CAAC;IACxF,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}