chief-clancy 0.2.0-beta.3 → 0.3.0

package/dist/scripts/once/once.js

@@ -0,0 +1,323 @@
+/**
+ * Unified once orchestrator — replaces all three `clancy-once-*.sh` scripts.
+ *
+ * Full lifecycle: preflight → detect board → fetch ticket → compute branches →
+ * [dry-run gate] → transition In Progress → create branch → invoke Claude →
+ * squash merge → transition Done → log → notify.
+ *
+ * All errors exit with code 0 (not 1). This is intentional — the AFK runner
+ * detects stop conditions by parsing stdout, not exit codes.
+ */
+import { closeIssue, fetchIssue as fetchGitHubIssue, isValidRepo, pingGitHub, } from '../../scripts/board/github/github.js';
+import { buildAuthHeader, fetchTicket as fetchJiraTicket, isSafeJqlValue, pingJira, transitionIssue as transitionJiraIssue, } from '../../scripts/board/jira/jira.js';
+import { fetchIssue as fetchLinearIssue, isValidTeamId, pingLinear, transitionIssue as transitionLinearIssue, } from '../../scripts/board/linear/linear.js';
+import { computeTargetBranch, computeTicketBranch, } from '../../scripts/shared/branch/branch.js';
+import { invokeClaudeSession } from '../../scripts/shared/claude-cli/claude-cli.js';
+import { detectBoard } from '../../scripts/shared/env-schema/env-schema.js';
+import { checkout, currentBranch, deleteBranch, ensureBranch, squashMerge, } from '../../scripts/shared/git-ops/git-ops.js';
+import { sendNotification } from '../../scripts/shared/notify/notify.js';
+import { runPreflight } from '../../scripts/shared/preflight/preflight.js';
+import { appendProgress } from '../../scripts/shared/progress/progress.js';
+import { buildPrompt } from '../../scripts/shared/prompt/prompt.js';
+import { bold, dim, green, red, yellow } from '../../utils/ansi/ansi.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function formatDuration(ms) {
+    const secs = Math.floor(ms / 1000);
+    if (secs < 60)
+        return `${secs}s`;
+    const mins = Math.floor(secs / 60);
+    const remSecs = secs % 60;
+    return remSecs > 0 ? `${mins}m ${remSecs}s` : `${mins}m`;
+}
+// ─── Board-specific fetch ────────────────────────────────────────────────────
+async function fetchTicket(config) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            const auth = buildAuthHeader(env.JIRA_USER, env.JIRA_API_TOKEN);
+            const ticket = await fetchJiraTicket(env.JIRA_BASE_URL, auth, env.JIRA_PROJECT_KEY, env.CLANCY_JQL_STATUS ?? 'To Do', env.CLANCY_JQL_SPRINT, env.CLANCY_LABEL);
+            if (!ticket)
+                return undefined;
+            const blockerStr = ticket.blockers.length
+                ? `Blocked by: ${ticket.blockers.join(', ')}`
+                : 'None';
+            return {
+                key: ticket.key,
+                title: ticket.title,
+                description: ticket.description,
+                parentInfo: ticket.epicKey ?? 'none',
+                blockers: blockerStr,
+            };
+        }
+        case 'github': {
+            const { env } = config;
+            const ticket = await fetchGitHubIssue(env.GITHUB_TOKEN, env.GITHUB_REPO, env.CLANCY_LABEL);
+            if (!ticket)
+                return undefined;
+            return {
+                key: ticket.key,
+                title: ticket.title,
+                description: ticket.description,
+                parentInfo: ticket.milestone ?? 'none',
+                blockers: 'None',
+            };
+        }
+        case 'linear': {
+            const { env } = config;
+            const ticket = await fetchLinearIssue({
+                LINEAR_API_KEY: env.LINEAR_API_KEY,
+                LINEAR_TEAM_ID: env.LINEAR_TEAM_ID,
+                CLANCY_LABEL: env.CLANCY_LABEL,
+            });
+            if (!ticket)
+                return undefined;
+            return {
+                key: ticket.key,
+                title: ticket.title,
+                description: ticket.description,
+                parentInfo: ticket.parentIdentifier ?? 'none',
+                blockers: 'None',
+                linearIssueId: ticket.issueId,
+            };
+        }
+    }
+}
+// ─── Board-specific ping ─────────────────────────────────────────────────────
+async function pingBoard(config) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            const auth = buildAuthHeader(env.JIRA_USER, env.JIRA_API_TOKEN);
+            return pingJira(env.JIRA_BASE_URL, env.JIRA_PROJECT_KEY, auth);
+        }
+        case 'github':
+            return pingGitHub(config.env.GITHUB_TOKEN, config.env.GITHUB_REPO);
+        case 'linear':
+            return pingLinear(config.env.LINEAR_API_KEY);
+    }
+}
+// ─── Board-specific validation ───────────────────────────────────────────────
+function validateInputs(config) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            if (!isSafeJqlValue(env.JIRA_PROJECT_KEY)) {
+                return '✗ JIRA_PROJECT_KEY contains invalid characters';
+            }
+            if (env.CLANCY_LABEL && !isSafeJqlValue(env.CLANCY_LABEL)) {
+                return '✗ CLANCY_LABEL contains invalid characters';
+            }
+            if (env.CLANCY_JQL_STATUS && !isSafeJqlValue(env.CLANCY_JQL_STATUS)) {
+                return '✗ CLANCY_JQL_STATUS contains invalid characters';
+            }
+            return undefined;
+        }
+        case 'github': {
+            if (!isValidRepo(config.env.GITHUB_REPO)) {
+                return '✗ GITHUB_REPO format is invalid — expected owner/repo';
+            }
+            return undefined;
+        }
+        case 'linear': {
+            if (!isValidTeamId(config.env.LINEAR_TEAM_ID)) {
+                return '✗ LINEAR_TEAM_ID contains invalid characters';
+            }
+            return undefined;
+        }
+    }
+}
+// ─── Board-specific transitions ──────────────────────────────────────────────
+async function transitionToStatus(config, ticket, statusName) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            const auth = buildAuthHeader(env.JIRA_USER, env.JIRA_API_TOKEN);
+            const issueKey = ticket.key;
+            const ok = await transitionJiraIssue(env.JIRA_BASE_URL, auth, issueKey, statusName);
+            if (ok)
+                console.log(`  → Transitioned to ${statusName}`);
+            break;
+        }
+        case 'github': {
+            // GitHub Issues only has open/closed — status transitions not applicable
+            // closeIssue is called separately after merge
+            break;
+        }
+        case 'linear': {
+            const { env } = config;
+            if (!ticket.linearIssueId)
+                break;
+            const ok = await transitionLinearIssue(env.LINEAR_API_KEY, env.LINEAR_TEAM_ID, ticket.linearIssueId, statusName);
+            if (ok)
+                console.log(`  → Transitioned to ${statusName}`);
+            break;
+        }
+    }
+}
+// ─── Main orchestrator ───────────────────────────────────────────────────────
+/**
+ * Run the once orchestrator — full ticket lifecycle.
+ *
+ * @param argv - Process arguments (supports `--dry-run` flag).
+ *
+ * @example
+ * ```ts
+ * await run(process.argv);
+ * ```
+ */
+export async function run(argv) {
+    const dryRun = argv.includes('--dry-run');
+    const startTime = Date.now();
+    console.log(dim('┌──────────────────────────────────────┐'));
+    console.log(dim('│') + bold('  🤖 Clancy — once mode              ') + dim('│'));
+    console.log(dim('│') + dim('  "Let\'s roll."                       ') + dim('│'));
+    console.log(dim('└──────────────────────────────────────┘'));
+    console.log('');
+    let originalBranch;
+    try {
+        // 1. Preflight
+        const preflight = runPreflight(process.cwd());
+        if (!preflight.ok) {
+            console.log(preflight.error);
+            return;
+        }
+        if (preflight.warning) {
+            console.log(preflight.warning);
+        }
+        // 2. Detect board
+        const boardResult = detectBoard(preflight.env);
+        if (typeof boardResult === 'string') {
+            console.log(boardResult);
+            return;
+        }
+        const config = boardResult;
+        // 3. Validate board-specific inputs
+        const validationError = validateInputs(config);
+        if (validationError) {
+            console.log(validationError);
+            return;
+        }
+        // 4. Ping board
+        const ping = await pingBoard(config);
+        if (!ping.ok) {
+            console.log(ping.error);
+            return;
+        }
+        console.log(green('✅ Preflight passed'));
+        // 5. Fetch ticket
+        const ticket = await fetchTicket(config);
+        if (!ticket) {
+            console.log(dim('No tickets found. All done!'));
+            return;
+        }
+        // 6. Compute branches
+        const baseBranch = config.env.CLANCY_BASE_BRANCH ?? 'main';
+        const parent = ticket.parentInfo !== 'none' ? ticket.parentInfo : undefined;
+        const ticketBranch = computeTicketBranch(config.provider, ticket.key);
+        const targetBranch = computeTargetBranch(config.provider, baseBranch, parent);
+        // 7. Dry-run gate
+        if (dryRun) {
+            const parentLabel = config.provider === 'github' ? 'Milestone' : 'Epic';
+            console.log('');
+            console.log(yellow('── Dry Run ──────────────────────────────────────'));
+            console.log(`  Ticket:         ${bold(`[${ticket.key}]`)} ${ticket.title}`);
+            console.log(`  ${parentLabel}:${' '.repeat(14 - parentLabel.length)}${ticket.parentInfo}`);
+            if (config.provider !== 'github') {
+                console.log(`  Blockers:       ${ticket.blockers}`);
+            }
+            console.log(`  Target branch:  ${ticketBranch} → ${targetBranch}`);
+            console.log(yellow('─────────────────────────────────────────────────'));
+            console.log(dim('  No changes made. Remove --dry-run to run for real.'));
+            return;
+        }
+        // 8. Print ticket info
+        const parentLabel = config.provider === 'github' ? 'Milestone' : 'Epic';
+        console.log('');
+        console.log(`🎫 ${bold(`[${ticket.key}]`)} ${ticket.title}`);
+        console.log(dim(`  ${parentLabel}: ${ticket.parentInfo} | Branch: ${ticketBranch} → ${targetBranch}`));
+        if (config.provider !== 'github' && ticket.blockers !== 'None') {
+            console.log(yellow(`  Blockers: ${ticket.blockers}`));
+        }
+        console.log('');
+        // 9. Git: set up branches
+        originalBranch = currentBranch();
+        ensureBranch(targetBranch, baseBranch);
+        checkout(targetBranch);
+        checkout(ticketBranch, true);
+        // 10. Transition to In Progress (best-effort)
+        const statusInProgress = config.env.CLANCY_STATUS_IN_PROGRESS;
+        if (statusInProgress) {
+            await transitionToStatus(config, ticket, statusInProgress);
+        }
+        // 11. Build prompt and invoke Claude
+        const prompt = buildPrompt({
+            provider: config.provider,
+            key: ticket.key,
+            title: ticket.title,
+            description: ticket.description,
+            parentInfo: ticket.parentInfo,
+            blockers: config.provider !== 'github' ? ticket.blockers : undefined,
+        });
+        const claudeOk = invokeClaudeSession(prompt, config.env.CLANCY_MODEL);
+        if (!claudeOk) {
+            console.log(yellow('⚠ Claude session exited with an error. Skipping merge.'));
+            return;
+        }
+        // 12. Squash merge
+        checkout(targetBranch);
+        const commitMsg = `feat(${ticket.key}): ${ticket.title}`;
+        const hadChanges = squashMerge(ticketBranch, commitMsg);
+        if (!hadChanges) {
+            console.log(yellow('⚠ No changes staged after squash merge. Claude may not have committed any work.'));
+        }
+        // 13. Delete feature branch
+        deleteBranch(ticketBranch);
+        // 14. Transition to Done / close issue (best-effort)
+        const statusDone = config.env.CLANCY_STATUS_DONE;
+        if (config.provider === 'github') {
+            const issueNumber = parseInt(ticket.key.replace('#', ''), 10);
+            if (Number.isNaN(issueNumber)) {
+                console.log(`⚠ Could not parse issue number from ${ticket.key}. Close it manually on GitHub.`);
+            }
+            else {
+                const closed = await closeIssue(config.env.GITHUB_TOKEN, config.env.GITHUB_REPO, issueNumber);
+                if (!closed) {
+                    console.log(`⚠ Could not close issue ${ticket.key}. Close it manually on GitHub.`);
+                }
+            }
+        }
+        else if (statusDone) {
+            await transitionToStatus(config, ticket, statusDone);
+        }
+        // 15. Log progress
+        appendProgress(process.cwd(), ticket.key, ticket.title, 'DONE');
+        const elapsed = formatDuration(Date.now() - startTime);
+        console.log('');
+        console.log(green(`🏁 ${ticket.key} complete`) + dim(` (${elapsed})`));
+        console.log(dim('  "Bake \'em away, toys."'));
+        // 16. Send notification (best-effort)
+        const webhook = config.env.CLANCY_NOTIFY_WEBHOOK;
+        if (webhook) {
+            await sendNotification(webhook, `✓ Clancy completed [${ticket.key}] ${ticket.title}`);
+        }
+    }
+    catch (error) {
+        // Unexpected errors — print and exit cleanly (exit 0 for AFK loop compat)
+        const msg = error instanceof Error ? error.message : String(error);
+        const elapsed = formatDuration(Date.now() - startTime);
+        console.error('');
+        console.error(red(`❌ Clancy stopped`) + dim(` (${elapsed})`));
+        console.error(red(`   ${msg}`));
+        console.error(dim('  "I\'d rather let Herman go."'));
+        // Best-effort: restore the branch the user was on before Clancy started
+        if (originalBranch) {
+            try {
+                checkout(originalBranch);
+            }
+            catch {
+                // Ignore — branch restore is best-effort
+            }
+        }
+    }
+}
+//# sourceMappingURL=once.js.map

package/dist/scripts/once/once.js.map

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

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

@@ -0,0 +1,50 @@
+/**
+ * Branch name computation for ticket workflows.
+ *
+ * Pure functions that compute feature and target branch names
+ * based on the board provider and ticket metadata.
+ */
+import type { BoardProvider } from '../../../types/index.js';
+/**
+ * Compute the feature branch name for a ticket.
+ *
+ * - Jira/Linear: `feature/{key-lowercase}` (e.g., `feature/proj-123`)
+ * - GitHub: `feature/issue-{number}` (e.g., `feature/issue-42`)
+ *
+ * @param provider - The board provider.
+ * @param key - The ticket key (e.g., `'PROJ-123'`, `'#42'`, `'ENG-123'`).
+ * @returns The feature branch name.
+ *
+ * @example
+ * ```ts
+ * computeTicketBranch('jira', 'PROJ-123');   // 'feature/proj-123'
+ * computeTicketBranch('github', '#42');       // 'feature/issue-42'
+ * computeTicketBranch('linear', 'ENG-123');   // 'feature/eng-123'
+ * ```
+ */
+export declare function computeTicketBranch(provider: BoardProvider, key: string): string;
+/**
+ * Compute the target branch for merging.
+ *
+ * If the ticket has a parent (epic/milestone), branches from that parent's
+ * branch. Otherwise falls back to the base branch.
+ *
+ * - Jira: epic key → `epic/{key-lowercase}`
+ * - GitHub: milestone → `milestone/{slug}`
+ * - Linear: parent identifier → `epic/{id-lowercase}`
+ *
+ * @param provider - The board provider.
+ * @param baseBranch - The default base branch (e.g., `'main'`).
+ * @param parent - Optional parent identifier (epic key, milestone title, parent ID).
+ * @returns The target branch name.
+ *
+ * @example
+ * ```ts
+ * computeTargetBranch('jira', 'main', 'PROJ-100');       // 'epic/proj-100'
+ * computeTargetBranch('github', 'main', 'Sprint 3');     // 'milestone/sprint-3'
+ * computeTargetBranch('linear', 'main', 'ENG-50');       // 'epic/eng-50'
+ * computeTargetBranch('jira', 'main');                   // 'main'
+ * ```
+ */
+export declare function computeTargetBranch(provider: BoardProvider, baseBranch: string, parent?: string): string;
+//# sourceMappingURL=branch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/branch/branch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,GACV,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAaR"}

package/dist/scripts/shared/branch/branch.js

@@ -0,0 +1,61 @@
+/**
+ * Compute the feature branch name for a ticket.
+ *
+ * - Jira/Linear: `feature/{key-lowercase}` (e.g., `feature/proj-123`)
+ * - GitHub: `feature/issue-{number}` (e.g., `feature/issue-42`)
+ *
+ * @param provider - The board provider.
+ * @param key - The ticket key (e.g., `'PROJ-123'`, `'#42'`, `'ENG-123'`).
+ * @returns The feature branch name.
+ *
+ * @example
+ * ```ts
+ * computeTicketBranch('jira', 'PROJ-123');   // 'feature/proj-123'
+ * computeTicketBranch('github', '#42');       // 'feature/issue-42'
+ * computeTicketBranch('linear', 'ENG-123');   // 'feature/eng-123'
+ * ```
+ */
+export function computeTicketBranch(provider, key) {
+    if (provider === 'github') {
+        const number = key.replace('#', '');
+        return `feature/issue-${number}`;
+    }
+    return `feature/${key.toLowerCase()}`;
+}
+/**
+ * Compute the target branch for merging.
+ *
+ * If the ticket has a parent (epic/milestone), branches from that parent's
+ * branch. Otherwise falls back to the base branch.
+ *
+ * - Jira: epic key → `epic/{key-lowercase}`
+ * - GitHub: milestone → `milestone/{slug}`
+ * - Linear: parent identifier → `epic/{id-lowercase}`
+ *
+ * @param provider - The board provider.
+ * @param baseBranch - The default base branch (e.g., `'main'`).
+ * @param parent - Optional parent identifier (epic key, milestone title, parent ID).
+ * @returns The target branch name.
+ *
+ * @example
+ * ```ts
+ * computeTargetBranch('jira', 'main', 'PROJ-100');       // 'epic/proj-100'
+ * computeTargetBranch('github', 'main', 'Sprint 3');     // 'milestone/sprint-3'
+ * computeTargetBranch('linear', 'main', 'ENG-50');       // 'epic/eng-50'
+ * computeTargetBranch('jira', 'main');                   // 'main'
+ * ```
+ */
+export function computeTargetBranch(provider, baseBranch, parent) {
+    if (!parent)
+        return baseBranch;
+    if (provider === 'github') {
+        const slug = parent
+            .toLowerCase()
+            .replace(/\s+/g, '-')
+            .replace(/[^a-z0-9-]/g, '');
+        return `milestone/${slug}`;
+    }
+    // Jira and Linear both use epic/ prefix
+    return `epic/${parent.toLowerCase()}`;
+}
+//# sourceMappingURL=branch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch.js","sourceRoot":"","sources":["../../../../src/scripts/shared/branch/branch.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAuB,EACvB,GAAW;IAEX,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpC,OAAO,iBAAiB,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,WAAW,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAuB,EACvB,UAAkB,EAClB,MAAe;IAEf,IAAI,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC;IAE/B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM;aAChB,WAAW,EAAE;aACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC9B,OAAO,aAAa,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,wCAAwC;IACxC,OAAO,QAAQ,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;AACxC,CAAC"}

package/dist/scripts/shared/claude-cli/claude-cli.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Invoke a Claude Code session with the given prompt.
+ *
+ * Pipes the prompt to stdin and streams stdout/stderr live.
+ * Uses `--dangerously-skip-permissions` for autonomous operation.
+ *
+ * @param prompt - The full implementation prompt.
+ * @param model - Optional model override (e.g., `'opus'`, `'sonnet'`).
+ * @returns `true` if Claude exited successfully (code 0), `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * invokeClaudeSession('You are implementing PROJ-123...', 'opus');
+ * ```
+ */
+export declare function invokeClaudeSession(prompt: string, model?: string): boolean;
+//# sourceMappingURL=claude-cli.d.ts.map

package/dist/scripts/shared/claude-cli/claude-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-cli.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/claude-cli/claude-cli.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAc3E"}

package/dist/scripts/shared/claude-cli/claude-cli.js

@@ -0,0 +1,35 @@
+/**
+ * Claude CLI invocation for ticket implementation.
+ *
+ * Spawns `claude --dangerously-skip-permissions` with the prompt piped
+ * to stdin. Output streams live to the user's terminal.
+ */
+import { spawnSync } from 'node:child_process';
+/**
+ * Invoke a Claude Code session with the given prompt.
+ *
+ * Pipes the prompt to stdin and streams stdout/stderr live.
+ * Uses `--dangerously-skip-permissions` for autonomous operation.
+ *
+ * @param prompt - The full implementation prompt.
+ * @param model - Optional model override (e.g., `'opus'`, `'sonnet'`).
+ * @returns `true` if Claude exited successfully (code 0), `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * invokeClaudeSession('You are implementing PROJ-123...', 'opus');
+ * ```
+ */
+export function invokeClaudeSession(prompt, model) {
+    const args = ['--dangerously-skip-permissions'];
+    if (model) {
+        args.push('--model', model);
+    }
+    const result = spawnSync('claude', args, {
+        input: prompt,
+        stdio: ['pipe', 'inherit', 'inherit'],
+        encoding: 'utf8',
+    });
+    return result.status === 0 && !result.error;
+}
+//# sourceMappingURL=claude-cli.js.map

package/dist/scripts/shared/claude-cli/claude-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-cli.js","sourceRoot":"","sources":["../../../../src/scripts/shared/claude-cli/claude-cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,KAAc;IAChE,MAAM,IAAI,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAEhD,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE;QACvC,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;QACrC,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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 `#`.
+ *
+ * @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 function parseEnvContent(content: string): Record<string, string>;
+/**
+ * Load environment variables from a `.clancy/.env` file.
+ *
+ * @param projectRoot - The root directory of the project containing `.clancy/`.
+ * @returns The parsed environment variables, or `undefined` if the file doesn't exist.
+ *
+ * @example
+ * ```ts
+ * const env = loadClancyEnv('/path/to/project');
+ * // env?.JIRA_BASE_URL === 'https://example.atlassian.net'
+ * ```
+ */
+export declare function loadClancyEnv(projectRoot: string): Record<string, string> | undefined;
+//# sourceMappingURL=env-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env-parser.d.ts","sourceRoot":"","sources":["../../../../src/scripts/shared/env-parser/env-parser.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQpC"}

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

@@ -0,0 +1,64 @@
+/**
+ * Clancy .env file parser.
+ *
+ * Reads key=value pairs from `.clancy/.env` files. Supports quoted values,
+ * comments, and blank lines. Does NOT use dotenv — zero dependencies.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * 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 `#`.
+ *
+ * @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 function parseEnvContent(content) {
+    const env = {};
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        let value = trimmed.slice(eqIndex + 1).trim();
+        // Strip surrounding quotes (minimum 2 chars to avoid stripping a lone quote)
+        if (value.length >= 2 &&
+            ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'")))) {
+            value = value.slice(1, -1);
+        }
+        env[key] = value;
+    }
+    return env;
+}
+/**
+ * Load environment variables from a `.clancy/.env` file.
+ *
+ * @param projectRoot - The root directory of the project containing `.clancy/`.
+ * @returns The parsed environment variables, or `undefined` if the file doesn't exist.
+ *
+ * @example
+ * ```ts
+ * const env = loadClancyEnv('/path/to/project');
+ * // env?.JIRA_BASE_URL === 'https://example.atlassian.net'
+ * ```
+ */
+export function loadClancyEnv(projectRoot) {
+    const envPath = join(projectRoot, '.clancy', '.env');
+    if (!existsSync(envPath))
+        return undefined;
+    const content = readFileSync(envPath, 'utf8');
+    return parseEnvContent(content);
+}
+//# sourceMappingURL=env-parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env-parser.js","sourceRoot":"","sources":["../../../../src/scripts/shared/env-parser/env-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAErC,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,SAAS;QAE7B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9C,6EAA6E;QAC7E,IACE,KAAK,CAAC,MAAM,IAAI,CAAC;YACjB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC7C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EACjD,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAmB;IAEnB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAErD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE9C,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}