specweave 2.3.0 → 3.0.0

package/dist/src/core/cicd/workflow-monitor.d.ts

@@ -1,102 +0,0 @@
-/**
- * CI/CD Workflow Monitor
- *
- * Monitors GitHub Actions workflows for failures by polling the GitHub API
- * every 60 seconds. Uses conditional requests and rate limit handling for
- * efficient API usage.
- */
-import { StateManager } from './state-manager.js';
-import { Logger } from '../../utils/logger.js';
-/**
- * Monitor configuration
- */
-export interface MonitorConfig {
-    /** GitHub API token */
-    token: string;
-    /** Repository owner */
-    owner: string;
-    /** Repository name */
-    repo: string;
-    /** Poll interval (milliseconds, default: 60000 = 60s) */
-    pollInterval?: number;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Logger instance (defaults to consoleLogger) */
-    logger?: Logger;
-}
-/**
- * Poll result
- */
-export interface PollResult {
-    /** Total runs checked */
-    totalRuns: number;
-    /** New failures detected */
-    newFailures: number;
-    /** Failures already tracked */
-    duplicates: number;
-    /** HTTP status code */
-    statusCode: number;
-    /** Rate limit remaining */
-    rateLimitRemaining: number;
-}
-/**
- * WorkflowMonitor - Polls GitHub Actions for workflow failures
- *
- * Features:
- * - Polls every 60 seconds (configurable)
- * - Detects failed workflow runs within 2 minutes
- * - Uses conditional requests (If-Modified-Since) to reduce API calls
- * - Handles rate limiting with exponential backoff
- * - Deduplicates failures via StateManager
- * - Extracts comprehensive workflow metadata
- */
-export declare class WorkflowMonitor {
-    private octokit;
-    private stateManager;
-    private config;
-    private logger;
-    private pollingTimer;
-    private lastModified;
-    private isPolling;
-    /**
-     * Create workflow monitor
-     *
-     * @param config - Monitor configuration
-     * @param stateManager - State manager instance (optional, creates new if not provided)
-     */
-    constructor(config: MonitorConfig, stateManager?: StateManager);
-    /**
-     * Start monitoring (begins polling)
-     */
-    start(): void;
-    /**
-     * Stop monitoring (stops polling)
-     */
-    stop(): void;
-    /**
-     * Check if monitor is running
-     */
-    isRunning(): boolean;
-    /**
-     * Poll GitHub Actions API for workflow runs
-     *
-     * @returns Poll result with statistics
-     */
-    poll(): Promise<PollResult>;
-    /**
-     * Extract failure record from GitHub workflow run
-     *
-     * @param run - GitHub workflow run data
-     * @returns Failure record for state storage
-     */
-    private extractFailureRecord;
-    /**
-     * Sleep for specified milliseconds
-     */
-    private sleep;
-    /**
-     * Debug logging
-     */
-    private log;
-}
-//# sourceMappingURL=workflow-monitor.d.ts.map

package/dist/src/core/cicd/workflow-monitor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-monitor.d.ts","sourceRoot":"","sources":["../../../../src/core/cicd/workflow-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IAEb,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;OAKG;gBAED,MAAM,EAAE,aAAa,EACrB,YAAY,GAAE,YAAiC;IAuBjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAmBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAwGjC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/src/core/cicd/workflow-monitor.js

@@ -1,211 +0,0 @@
-/**
- * CI/CD Workflow Monitor
- *
- * Monitors GitHub Actions workflows for failures by polling the GitHub API
- * every 60 seconds. Uses conditional requests and rate limit handling for
- * efficient API usage.
- */
-import { Octokit } from '@octokit/rest';
-import { StateManager } from './state-manager.js';
-import { consoleLogger } from '../../utils/logger.js';
-/**
- * WorkflowMonitor - Polls GitHub Actions for workflow failures
- *
- * Features:
- * - Polls every 60 seconds (configurable)
- * - Detects failed workflow runs within 2 minutes
- * - Uses conditional requests (If-Modified-Since) to reduce API calls
- * - Handles rate limiting with exponential backoff
- * - Deduplicates failures via StateManager
- * - Extracts comprehensive workflow metadata
- */
-export class WorkflowMonitor {
-    /**
-     * Create workflow monitor
-     *
-     * @param config - Monitor configuration
-     * @param stateManager - State manager instance (optional, creates new if not provided)
-     */
-    constructor(config, stateManager = new StateManager()) {
-        this.pollingTimer = null;
-        this.lastModified = null;
-        this.isPolling = false;
-        // Validate config
-        if (!config.token) {
-            throw new Error('GitHub token is required');
-        }
-        if (!config.owner || !config.repo) {
-            throw new Error('Repository owner and name are required');
-        }
-        this.config = {
-            token: config.token,
-            owner: config.owner,
-            repo: config.repo,
-            pollInterval: config.pollInterval ?? 60000, // Default: 60s
-            debug: config.debug ?? false
-        };
-        this.logger = config.logger ?? consoleLogger;
-        this.octokit = new Octokit({ auth: config.token });
-        this.stateManager = stateManager;
-    }
-    /**
-     * Start monitoring (begins polling)
-     */
-    start() {
-        if (this.isPolling) {
-            this.log('Monitor already running');
-            return;
-        }
-        this.isPolling = true;
-        this.log('Starting monitor...');
-        // Initial poll + schedule recurring polls
-        const runPoll = () => {
-            this.poll().catch((error) => console.error('Poll failed:', error));
-        };
-        runPoll();
-        this.pollingTimer = setInterval(runPoll, this.config.pollInterval);
-        this.log(`Monitor started (polling every ${this.config.pollInterval}ms)`);
-    }
-    /**
-     * Stop monitoring (stops polling)
-     */
-    stop() {
-        if (!this.isPolling) {
-            this.log('Monitor not running');
-            return;
-        }
-        if (this.pollingTimer) {
-            clearInterval(this.pollingTimer);
-            this.pollingTimer = null;
-        }
-        this.isPolling = false;
-        this.log('Monitor stopped');
-    }
-    /**
-     * Check if monitor is running
-     */
-    isRunning() {
-        return this.isPolling;
-    }
-    /**
-     * Poll GitHub Actions API for workflow runs
-     *
-     * @returns Poll result with statistics
-     */
-    async poll() {
-        this.log('Polling GitHub Actions API...');
-        try {
-            // Build request headers
-            const headers = {};
-            if (this.lastModified) {
-                headers['If-Modified-Since'] = this.lastModified;
-            }
-            // Fetch workflow runs
-            const response = await this.octokit.rest.actions.listWorkflowRunsForRepo({
-                owner: this.config.owner,
-                repo: this.config.repo,
-                status: 'completed', // Only completed runs
-                per_page: 100, // Max per page
-                headers
-            });
-            // Extract rate limit info
-            const rateLimitRemaining = parseInt(response.headers['x-ratelimit-remaining'] || '0', 10);
-            this.log(`Rate limit remaining: ${rateLimitRemaining}`);
-            // Handle 304 Not Modified (no new runs)
-            // Note: Octokit types response.status as 200, but API can return 304
-            if (response.status === 304) {
-                this.log('No new workflow runs (304 Not Modified)');
-                return {
-                    totalRuns: 0,
-                    newFailures: 0,
-                    duplicates: 0,
-                    statusCode: 304,
-                    rateLimitRemaining
-                };
-            }
-            // Update Last-Modified header for next request
-            if (response.headers['last-modified']) {
-                this.lastModified = response.headers['last-modified'];
-            }
-            // Filter failed runs
-            const failedRuns = response.data.workflow_runs.filter((run) => run.conclusion === 'failure');
-            this.log(`Found ${failedRuns.length} failed runs (of ${response.data.workflow_runs.length} total)`);
-            // Load state once to check for duplicates
-            const state = await this.stateManager.loadState();
-            let newFailures = 0;
-            let duplicates = 0;
-            for (const run of failedRuns) {
-                if (state.failures[run.id]) {
-                    duplicates++;
-                    continue;
-                }
-                await this.stateManager.addFailure(this.extractFailureRecord(run));
-                newFailures++;
-                this.log(`New failure detected: ${run.name} (run #${run.run_number})`);
-            }
-            // Update last poll timestamp
-            await this.stateManager.updateLastPoll();
-            return {
-                totalRuns: response.data.workflow_runs.length,
-                newFailures,
-                duplicates,
-                statusCode: response.status,
-                rateLimitRemaining
-            };
-        }
-        catch (error) {
-            // Handle rate limiting (429)
-            if (error.status === 429) {
-                const retryAfter = parseInt(error.response?.headers['retry-after'] || '60', 10);
-                console.warn(`Rate limited! Retry after ${retryAfter}s`);
-                // Exponential backoff
-                await this.sleep(retryAfter * 1000);
-                // Retry poll
-                return this.poll();
-            }
-            // Handle other errors
-            this.logger.error('Poll error:', error.message);
-            return {
-                totalRuns: 0,
-                newFailures: 0,
-                duplicates: 0,
-                statusCode: error.status || 500,
-                rateLimitRemaining: 0
-            };
-        }
-    }
-    /**
-     * Extract failure record from GitHub workflow run
-     *
-     * @param run - GitHub workflow run data
-     * @returns Failure record for state storage
-     */
-    extractFailureRecord(run) {
-        return {
-            runId: run.id,
-            workflowName: run.name,
-            commitSha: run.head_sha,
-            branch: run.head_branch,
-            detectedAt: new Date().toISOString(),
-            processed: false,
-            analyzed: false,
-            fixed: false,
-            url: run.html_url
-        };
-    }
-    /**
-     * Sleep for specified milliseconds
-     */
-    sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    /**
-     * Debug logging
-     */
-    log(message) {
-        if (this.config.debug) {
-            console.log(`[WorkflowMonitor] ${message}`);
-        }
-    }
-}
-//# sourceMappingURL=workflow-monitor.js.map

package/dist/src/core/cicd/workflow-monitor.js.map

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

package/dist/src/core/closure-dispatcher.d.ts

@@ -1,96 +0,0 @@
-/**
- * Closure Hook Dispatcher
- *
- * Dispatches increment closure to external tool providers (GitHub, JIRA, ADO)
- * using the function-map pattern per ADR-0240.
- *
- * Design:
- * - Each provider is a function, not an adapter class
- * - Partial failures are isolated — one provider crashing doesn't block others
- * - incrementClosed is always true (closure is a local SpecWeave operation;
- *   external sync failures are non-blocking)
- * - Provider functions are injected for testability; production wiring
- *   lazy-imports plugin modules
- *
- * @module core/closure-dispatcher
- */
-/**
- * Context passed to each provider close function.
- */
-export interface ClosureContext {
-    projectRoot: string;
-    incrementId: string;
-}
-/**
- * Per-provider toggle config for closure hooks.
- */
-export interface ClosureConfig {
-    github: boolean;
-    jira: boolean;
-    ado: boolean;
-}
-/**
- * Result from a single provider close function.
- */
-export interface ProviderCloseResult {
-    closed: string[];
-    provider: string;
-}
-/**
- * Signature for a provider close function.
- */
-export type ProviderCloseFn = (context: ClosureContext) => Promise<ProviderCloseResult>;
-/**
- * Failure detail for a single provider.
- */
-export interface ClosureFailure {
-    provider: string;
-    error: string;
-}
-/**
- * Aggregate result from dispatching closure to all providers.
- */
-export interface ClosureResult {
-    /** Always true — increment closure is a local operation */
-    incrementClosed: boolean;
-    /** Providers that succeeded */
-    successes: ProviderCloseResult[];
-    /** Providers that failed (non-blocking) */
-    failures: ClosureFailure[];
-}
-/**
- * Dispatch closure to all enabled providers.
- *
- * Each provider runs independently — failures are captured, not propagated.
- * The function-map pattern (ADR-0240) keeps this flat and simple:
- * no adapter interfaces, no orchestrator classes.
- *
- * @param context - Project root and increment ID
- * @param config - Per-provider enable/disable flags
- * @param closeFns - Map of provider name → close function (injected for testing)
- */
-export declare function dispatchClosure(context: ClosureContext, config: ClosureConfig, closeFns: Record<string, ProviderCloseFn>): Promise<ClosureResult>;
-/**
- * Build production close functions that lazy-import plugin modules.
- *
- * Called by SyncCoordinator to get the real provider functions.
- * Each function lazy-imports its plugin to avoid loading unused providers.
- */
-export declare function buildProductionCloseFns(): Record<string, ProviderCloseFn>;
-/**
- * Build closure config from SpecWeave hooks configuration.
- *
- * Reads the post_increment_done section and maps legacy flag names
- * to per-provider booleans. All default to true when not specified.
- */
-export declare function buildClosureConfigFromHooks(hooks?: {
-    post_increment_done?: {
-        close_github_issue?: boolean;
-        close_jira_issue?: boolean;
-        close_ado_work_item?: boolean;
-        close_external_issue?: boolean;
-    };
-}, syncSettings?: {
-    canUpdateExternalItems?: boolean;
-}): ClosureConfig;
-//# sourceMappingURL=closure-dispatcher.d.ts.map

package/dist/src/core/closure-dispatcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"closure-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/closure-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,+BAA+B;IAC/B,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GACxC,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAuCzE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,CAAC,EAAE;IACN,mBAAmB,CAAC,EAAE;QACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH,EACD,YAAY,CAAC,EAAE;IAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,aAAa,CAaf"}

package/dist/src/core/closure-dispatcher.js

@@ -1,116 +0,0 @@
-/**
- * Closure Hook Dispatcher
- *
- * Dispatches increment closure to external tool providers (GitHub, JIRA, ADO)
- * using the function-map pattern per ADR-0240.
- *
- * Design:
- * - Each provider is a function, not an adapter class
- * - Partial failures are isolated — one provider crashing doesn't block others
- * - incrementClosed is always true (closure is a local SpecWeave operation;
- *   external sync failures are non-blocking)
- * - Provider functions are injected for testability; production wiring
- *   lazy-imports plugin modules
- *
- * @module core/closure-dispatcher
- */
-const PROVIDERS = ['github', 'jira', 'ado'];
-/**
- * Dispatch closure to all enabled providers.
- *
- * Each provider runs independently — failures are captured, not propagated.
- * The function-map pattern (ADR-0240) keeps this flat and simple:
- * no adapter interfaces, no orchestrator classes.
- *
- * @param context - Project root and increment ID
- * @param config - Per-provider enable/disable flags
- * @param closeFns - Map of provider name → close function (injected for testing)
- */
-export async function dispatchClosure(context, config, closeFns) {
-    const successes = [];
-    const failures = [];
-    const tasks = PROVIDERS
-        .filter((p) => config[p])
-        .filter((p) => closeFns[p] != null)
-        .map(async (provider) => {
-        try {
-            const result = await closeFns[provider](context);
-            successes.push(result);
-        }
-        catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
-            failures.push({ provider, error: msg });
-        }
-    });
-    await Promise.all(tasks);
-    return {
-        incrementClosed: true,
-        successes,
-        failures,
-    };
-}
-/**
- * Build production close functions that lazy-import plugin modules.
- *
- * Called by SyncCoordinator to get the real provider functions.
- * Each function lazy-imports its plugin to avoid loading unused providers.
- */
-export function buildProductionCloseFns() {
-    return {
-        github: async (ctx) => {
-            const { SyncCoordinator } = await import('../sync/sync-coordinator.js');
-            const coordinator = new SyncCoordinator({
-                projectRoot: ctx.projectRoot,
-                incrementId: ctx.incrementId,
-            });
-            const result = await coordinator.syncIncrementClosure();
-            return {
-                closed: (result?.closedIssues ?? []).map(String),
-                provider: 'github',
-            };
-        },
-        jira: async (ctx) => {
-            const { SyncCoordinator } = await import('../sync/sync-coordinator.js');
-            const coordinator = new SyncCoordinator({
-                projectRoot: ctx.projectRoot,
-                incrementId: ctx.incrementId,
-            });
-            const result = await coordinator.syncIncrementClosure();
-            return {
-                closed: (result?.closedIssues ?? []).map(String),
-                provider: 'jira',
-            };
-        },
-        ado: async (ctx) => {
-            const { SyncCoordinator } = await import('../sync/sync-coordinator.js');
-            const coordinator = new SyncCoordinator({
-                projectRoot: ctx.projectRoot,
-                incrementId: ctx.incrementId,
-            });
-            const result = await coordinator.syncIncrementClosure();
-            return {
-                closed: (result?.closedIssues ?? []).map(String),
-                provider: 'ado',
-            };
-        },
-    };
-}
-/**
- * Build closure config from SpecWeave hooks configuration.
- *
- * Reads the post_increment_done section and maps legacy flag names
- * to per-provider booleans. All default to true when not specified.
- */
-export function buildClosureConfigFromHooks(hooks, syncSettings) {
-    const canUpdate = syncSettings?.canUpdateExternalItems ?? true;
-    const done = hooks?.post_increment_done;
-    if (!canUpdate || !done) {
-        return { github: false, jira: false, ado: false };
-    }
-    return {
-        github: done.close_github_issue ?? done.close_external_issue ?? true,
-        jira: done.close_jira_issue ?? done.close_external_issue ?? true,
-        ado: done.close_ado_work_item ?? done.close_external_issue ?? true,
-    };
-}
-//# sourceMappingURL=closure-dispatcher.js.map

package/dist/src/core/closure-dispatcher.js.map

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

package/dist/src/core/comment-builder.d.ts

@@ -1,57 +0,0 @@
-/**
- * Comment Builder for External Tool Sync
- *
- * Generates formatted comments for posting to external tools
- * (GitHub, JIRA, Azure DevOps) with commit/PR links and summaries.
- */
-import { GitCommit, GitRepository, PullRequest } from '../utils/git-utils.js';
-import { Task, UserStory } from './specs/spec-task-mapper.js';
-export interface CommentContent {
-    userStory: UserStory;
-    tasks: Task[];
-    commits: GitCommit[];
-    pullRequests: PullRequest[];
-    summary: string;
-}
-export interface FormattedComment {
-    markdown: string;
-    html?: string;
-    plain?: string;
-}
-/**
- * Build comment for completed user story
- */
-export declare function buildUserStoryComment(content: CommentContent, repo: GitRepository): FormattedComment;
-/**
- * Build short summary comment (for quick updates)
- */
-export declare function buildShortComment(commits: GitCommit[], repo: GitRepository, summary?: string): FormattedComment;
-/**
- * Build comment for multiple commits (batch update)
- */
-export declare function buildCommitBatchComment(commits: GitCommit[], repo: GitRepository, groupByDate?: boolean): FormattedComment;
-/**
- * Build comment for PR merge
- */
-export declare function buildPRMergeComment(pr: PullRequest, commits: GitCommit[], repo: GitRepository): FormattedComment;
-/**
- * Generate smart summary from commits
- */
-export declare function generateSmartSummary(commits: GitCommit[], tasks: Task[]): string;
-/**
- * Format comment for JIRA (converts markdown to JIRA markup)
- */
-export declare function formatForJira(comment: FormattedComment): string;
-/**
- * Format comment for Azure DevOps (HTML)
- */
-export declare function formatForAdo(comment: FormattedComment): string;
-/**
- * Validate comment size (some platforms have limits)
- */
-export declare function validateCommentSize(comment: FormattedComment, maxLength?: number): boolean;
-/**
- * Truncate comment if too long
- */
-export declare function truncateComment(comment: FormattedComment, maxLength?: number): FormattedComment;
-//# sourceMappingURL=comment-builder.d.ts.map

package/dist/src/core/comment-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"comment-builder.d.ts","sourceRoot":"","sources":["../../../src/core/comment-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,aAAa,GAClB,gBAAgB,CAwDlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,CAsBlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,EACnB,WAAW,GAAE,OAAc,GAC1B,gBAAgB,CA8ClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,GAClB,gBAAgB,CAyBlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,EAAE,IAAI,EAAE,GACZ,MAAM,CAoCR;AAaD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAuB/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,MAAa,GACvB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,MAAa,GACvB,gBAAgB,CAYlB"}