chief-clancy 0.2.0 → 0.3.1

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"}

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

@@ -0,0 +1,25 @@
+/**
+ * Format a date as `YYYY-MM-DD HH:MM`.
+ *
+ * @param date - The date to format.
+ * @returns The formatted date string.
+ */
+export declare function formatTimestamp(date: Date): string;
+/**
+ * Append a progress entry to `.clancy/progress.txt`.
+ *
+ * Creates the file and parent directories if they don't exist.
+ *
+ * @param projectRoot - The root directory of the project.
+ * @param key - The ticket key (e.g., `'PROJ-123'`, `'#42'`).
+ * @param summary - The ticket summary/title.
+ * @param status - The completion status (`'DONE'` or `'SKIPPED'`).
+ *
+ * @example
+ * ```ts
+ * appendProgress('/path/to/project', 'PROJ-123', 'Add login page', 'DONE');
+ * // Appends: "2024-01-15 14:30 | PROJ-123 | Add login page | DONE"
+ * ```
+ */
+export declare function appendProgress(projectRoot: string, key: string, summary: string, status: 'DONE' | 'SKIPPED'): void;
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/progress/progress.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQlD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,IAAI,CASN"}

package/dist/scripts/shared/progress/progress.js

@@ -0,0 +1,46 @@
+/**
+ * Progress logger for completed tickets.
+ *
+ * Appends entries to `.clancy/progress.txt` with a timestamp,
+ * ticket key, summary, and status.
+ */
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/**
+ * Format a date as `YYYY-MM-DD HH:MM`.
+ *
+ * @param date - The date to format.
+ * @returns The formatted date string.
+ */
+export function formatTimestamp(date) {
+    const y = date.getFullYear();
+    const mo = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    const h = String(date.getHours()).padStart(2, '0');
+    const mi = String(date.getMinutes()).padStart(2, '0');
+    return `${y}-${mo}-${d} ${h}:${mi}`;
+}
+/**
+ * Append a progress entry to `.clancy/progress.txt`.
+ *
+ * Creates the file and parent directories if they don't exist.
+ *
+ * @param projectRoot - The root directory of the project.
+ * @param key - The ticket key (e.g., `'PROJ-123'`, `'#42'`).
+ * @param summary - The ticket summary/title.
+ * @param status - The completion status (`'DONE'` or `'SKIPPED'`).
+ *
+ * @example
+ * ```ts
+ * appendProgress('/path/to/project', 'PROJ-123', 'Add login page', 'DONE');
+ * // Appends: "2024-01-15 14:30 | PROJ-123 | Add login page | DONE"
+ * ```
+ */
+export function appendProgress(projectRoot, key, summary, status) {
+    const filePath = join(projectRoot, '.clancy', 'progress.txt');
+    mkdirSync(dirname(filePath), { recursive: true });
+    const timestamp = formatTimestamp(new Date());
+    const line = `${timestamp} | ${key} | ${summary} | ${status}\n`;
+    appendFileSync(filePath, line, 'utf8');
+}
+//# sourceMappingURL=progress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../../src/scripts/shared/progress/progress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEtD,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,GAAW,EACX,OAAe,EACf,MAA0B;IAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAE9D,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,SAAS,MAAM,GAAG,MAAM,OAAO,MAAM,MAAM,IAAI,CAAC;IAEhE,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Claude prompt builder for ticket implementation.
+ *
+ * Generates the full prompt string piped to `claude --dangerously-skip-permissions`.
+ * The prompt structure matches the original shell scripts exactly.
+ */
+import type { BoardProvider } from '../../../types/index.js';
+type PromptInput = {
+    provider: BoardProvider;
+    key: string;
+    title: string;
+    description: string;
+    /** Epic/milestone/parent info string (e.g., `'PROJ-100'`, `'Sprint 3'`, `'none'`). */
+    parentInfo: string;
+    /** Blocker info string (e.g., `'Blocked by: PROJ-99, PROJ-98'` or `'None'`). */
+    blockers?: string;
+};
+/**
+ * Build the full Claude prompt for implementing a ticket.
+ *
+ * @param input - The ticket data for the prompt.
+ * @returns The complete prompt string.
+ *
+ * @example
+ * ```ts
+ * const prompt = buildPrompt({
+ *   provider: 'jira',
+ *   key: 'PROJ-123',
+ *   title: 'Add login page',
+ *   description: 'Create a login page with email/password fields.',
+ *   parentInfo: 'PROJ-100',
+ *   blockers: 'None',
+ * });
+ * ```
+ */
+export declare function buildPrompt(input: PromptInput): string;
+export {};
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/prompt/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA6BF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAkCtD"}

package/dist/scripts/shared/prompt/prompt.js

@@ -0,0 +1,77 @@
+/**
+ * Get the board-specific label for the ticket type.
+ *
+ * @param provider - The board provider.
+ * @returns The label used in prompts (e.g., `'Jira ticket'`, `'GitHub Issue'`).
+ */
+function ticketLabel(provider) {
+    switch (provider) {
+        case 'jira':
+            return 'Jira ticket';
+        case 'github':
+            return 'GitHub Issue';
+        case 'linear':
+            return 'Linear issue';
+    }
+}
+/**
+ * Get the board-specific label for the parent grouping.
+ *
+ * @param provider - The board provider.
+ * @returns The label (e.g., `'Epic'`, `'Milestone'`).
+ */
+function parentLabel(provider) {
+    return provider === 'github' ? 'Milestone' : 'Epic';
+}
+/**
+ * Build the full Claude prompt for implementing a ticket.
+ *
+ * @param input - The ticket data for the prompt.
+ * @returns The complete prompt string.
+ *
+ * @example
+ * ```ts
+ * const prompt = buildPrompt({
+ *   provider: 'jira',
+ *   key: 'PROJ-123',
+ *   title: 'Add login page',
+ *   description: 'Create a login page with email/password fields.',
+ *   parentInfo: 'PROJ-100',
+ *   blockers: 'None',
+ * });
+ * ```
+ */
+export function buildPrompt(input) {
+    const label = ticketLabel(input.provider);
+    const pLabel = parentLabel(input.provider);
+    const blockerLine = input.blockers && input.provider !== 'github'
+        ? `\nBlockers: ${input.blockers}`
+        : '';
+    return `You are implementing ${label} ${input.key}.
+
+${input.provider === 'github' ? 'Title' : 'Summary'}: ${input.title}
+${pLabel}: ${input.parentInfo}${blockerLine}
+
+Description:
+${input.description}
+
+Step 0 — Executability check (do this before any git or file operation):
+Read the ${input.provider === 'github' ? 'issue title and description' : 'ticket summary and description'} above. Can this ${input.provider === 'github' ? 'issue' : 'ticket'} be implemented entirely
+as a code change committed to this repo? Consult the 'Executability check' section of
+CLAUDE.md for the full list of skip conditions.
+
+If you must SKIP this ${input.provider === 'github' ? 'issue' : 'ticket'}:
+1. Output: ⚠ Skipping [${input.key}]: {one-line reason}
+2. Output: Ticket skipped — update it to be codebase-only work, then re-run.
+3. Append to .clancy/progress.txt: YYYY-MM-DD HH:MM | ${input.key} | {reason} | SKIPPED
+4. Stop — no branches, no file changes, no git operations.
+
+If the ${input.provider === 'github' ? 'issue' : 'ticket'} IS implementable, continue:
+1. Read core docs in .clancy/docs/: STACK.md, ARCHITECTURE.md, CONVENTIONS.md, GIT.md, DEFINITION-OF-DONE.md, CONCERNS.md
+   Also read if relevant to this ticket: INTEGRATIONS.md (external APIs/services/auth), TESTING.md (tests/specs/coverage), DESIGN-SYSTEM.md (UI/components/styles), ACCESSIBILITY.md (accessibility/ARIA/WCAG)
+2. Follow the conventions in GIT.md exactly
+3. Implement the ${input.provider === 'github' ? 'issue' : 'ticket'} fully
+4. Commit your work following the conventions in GIT.md
+5. When done, confirm you are finished.`;
+}
+//# sourceMappingURL=prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/scripts/shared/prompt/prompt.ts"],"names":[],"mappings":"AAmBA;;;;;GAKG;AACH,SAAS,WAAW,CAAC,QAAuB;IAC1C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,aAAa,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,cAAc,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,cAAc,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,QAAuB;IAC1C,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,WAAW,GACf,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAC3C,CAAC,CAAC,eAAe,KAAK,CAAC,QAAQ,EAAE;QACjC,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,wBAAwB,KAAK,IAAI,KAAK,CAAC,GAAG;;EAEjD,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK;EACjE,MAAM,KAAK,KAAK,CAAC,UAAU,GAAG,WAAW;;;EAGzC,KAAK,CAAC,WAAW;;;WAGR,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,gCAAgC,oBAAoB,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;;;;wBAIrJ,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;yBAC/C,KAAK,CAAC,GAAG;;wDAEsB,KAAK,CAAC,GAAG;;;SAGxD,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;;;;mBAItC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;;wCAE3B,CAAC;AACzC,CAAC"}

package/dist/types/board.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Board-related types shared across board scripts.
+ */
+/** Supported board providers. */
+export type BoardProvider = 'jira' | 'github' | 'linear';
+/** A normalised ticket from any board provider. */
+export type Ticket = {
+    key: string;
+    title: string;
+    description: string;
+    provider: BoardProvider;
+};
+//# sourceMappingURL=board.d.ts.map

package/dist/types/board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/types/board.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,mDAAmD;AACnD,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;CACzB,CAAC"}

package/dist/types/board.js

@@ -0,0 +1,5 @@
+/**
+ * Board-related types shared across board scripts.
+ */
+export {};
+//# sourceMappingURL=board.js.map

package/dist/types/board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/types/board.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { BoardProvider, Ticket } from './board.js';
+export type { BoardConfig, GitHubEnv, JiraEnv, LinearEnv, SharedEnv, } from '../schemas/env.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/ansi/ansi.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ANSI escape code helpers for terminal output.
+ *
+ * Wraps strings in ANSI sequences for styling in CLI environments.
+ */
+/**
+ * Dim the given string (reduced intensity).
+ *
+ * @param s - The string to style.
+ * @returns The string wrapped in ANSI dim codes.
+ */
+export declare const dim: (s: string) => string;
+/**
+ * Bold the given string.
+ *
+ * @param s - The string to style.
+ * @returns The string wrapped in ANSI bold codes.
+ */
+export declare const bold: (s: string) => string;
+/**
+ * Colour the given string blue (bold).
+ *
+ * @param s - The string to style.
+ * @returns The string wrapped in ANSI blue codes.
+ */
+export declare const blue: (s: string) => string;
+/**
+ * Colour the given string cyan.
+ *
+ * @param s - The string to style.
+ * @returns The string wrapped in ANSI cyan codes.
+ */
+export declare const cyan: (s: string) => string;
+/**
+ * Colour the given string green.
+ *
+ * @param s - The string to style.
+ * @returns The string wrapped in ANSI green codes.
+ */
+export declare const green: (s: string) => string;
+/**
+ * Colour the given string red.
+ *
+ * @param s - The string to style.
+ * @returns The string wrapped in ANSI red codes.
+ */
+export declare const red: (s: string) => string;
+/**
+ * Colour the given string yellow.
+ *
+ * @param s - The string to style.
+ * @returns The string wrapped in ANSI yellow codes.
+ */
+export declare const yellow: (s: string) => string;
+//# sourceMappingURL=ansi.d.ts.map