specweave 0.13.6 → 0.15.0

package/dist/src/core/types/sync-profile.d.ts

@@ -0,0 +1,403 @@
+/**
+ * Sync Profile Types for Multi-Project External Integration
+ *
+ * Supports multiple projects per provider (GitHub, JIRA, ADO, etc.)
+ * with time range filtering and rate limiting protection.
+ */
+export type SyncProvider = 'github' | 'jira' | 'ado';
+/**
+ * Sync Strategy (v0.10.0+)
+ *
+ * Determines how work is organized and synced:
+ * - simple: One container (project/repo), no filtering (default, backward compatible)
+ * - filtered: Multiple containers + sub-organizations (boards/etc) + filters (NEW)
+ * - custom: Raw query (JQL/GraphQL/WIQL) for power users (NEW)
+ */
+export type SyncStrategy = 'simple' | 'filtered' | 'custom';
+export type JiraStrategy = 'project-per-team' | 'shared-project-with-components';
+/**
+ * Container filters (provider-specific)
+ *
+ * Filters applied to a specific container (project/repo) to narrow down synced items.
+ */
+export interface SyncContainerFilters {
+    /** Include items with these labels */
+    includeLabels?: string[];
+    /** Exclude items with these labels */
+    excludeLabels?: string[];
+    /** Filter by assignees (email or ID) */
+    assignees?: string[];
+    /** Filter by status categories */
+    statusCategories?: string[];
+    /** Filter by components */
+    components?: string[];
+    /** Filter by sprints */
+    sprints?: string[];
+    /** Filter by issue types (Epic, Story, Task, Bug) */
+    issueTypes?: string[];
+    /** Filter by milestones */
+    milestones?: string[];
+    /** Filter by states */
+    states?: ('open' | 'closed')[];
+    /** Filter by area paths */
+    areaPaths?: string[];
+    /** Filter by iteration paths */
+    iterationPaths?: string[];
+    /** Filter by work item types (Epic, Feature, User Story, Bug) */
+    workItemTypes?: string[];
+}
+/**
+ * Container definition (project, repo, etc.)
+ *
+ * Represents a single container (Jira project, GitHub repo, ADO project) with optional sub-organizations.
+ */
+export interface SyncContainer {
+    /**
+     * Container ID
+     * - Jira: Project key (e.g., "PROJECT-A")
+     * - GitHub: Repository (e.g., "owner/repo-name")
+     * - ADO: Project name (e.g., "Platform")
+     */
+    id: string;
+    /**
+     * Sub-organizations within the container
+     * - Jira: Board names (e.g., ["Team Alpha Board", "Team Beta Board"])
+     * - GitHub: Project board titles (e.g., ["Frontend Board", "UI Components"])
+     * - ADO: Team board names (e.g., ["API Team Board"])
+     */
+    subOrganizations?: string[];
+    /**
+     * Filters applied to this container
+     */
+    filters?: SyncContainerFilters;
+}
+/**
+ * GitHub Configuration (Extended for Hierarchical Sync)
+ *
+ * - Simple strategy: owner + repo (backward compatible)
+ * - Filtered strategy: containers array with multiple repos
+ * - Custom strategy: customQuery (GitHub search syntax)
+ */
+export interface GitHubConfig {
+    owner?: string;
+    repo?: string;
+    containers?: SyncContainer[];
+    customQuery?: string;
+}
+/**
+ * Jira Configuration (Extended for Hierarchical Sync)
+ *
+ * Supports:
+ * - Simple strategy: Single project (projectKey) - backward compatible
+ * - Filtered strategy: Multiple projects + boards (containers) - NEW in v0.10.0
+ * - Custom strategy: Raw JQL query (customQuery) - NEW in v0.10.0
+ *
+ * Backward Compatibility:
+ * - Old config: { domain, projectKey } - still works (simple strategy)
+ * - Old config: { domain, strategy, projects/components } - still works (deprecated, use filtered)
+ * - New config: { domain, containers: [{id, subOrganizations, filters}] } - hierarchical
+ */
+export interface JiraConfig {
+    domain: string;
+    issueType?: 'Epic' | 'Story' | 'Task';
+    /**
+     * @deprecated Use SyncStrategy instead (simple/filtered/custom)
+     * Old field: How teams are organized in Jira
+     */
+    strategy?: JiraStrategy;
+    /**
+     * @deprecated Use containers array instead
+     * Strategy 1: Multiple projects (one per team)
+     */
+    projects?: string[];
+    /**
+     * @deprecated Use containers array instead
+     * Strategy 2: Single project key OR shared project
+     */
+    projectKey?: string;
+    /**
+     * @deprecated Use filters in SyncContainer instead
+     * Components for filtering
+     */
+    components?: string[];
+    /**
+     * Filtered strategy: Multiple projects + boards
+     * Example: [
+     *   {id: "PROJECT-A", subOrganizations: ["Board 1", "Board 2"], filters: {...}},
+     *   {id: "PROJECT-B", subOrganizations: ["Board 3"]}
+     * ]
+     */
+    containers?: SyncContainer[];
+    /**
+     * Custom strategy: Raw JQL query
+     * Example: "project IN (PROJECT-A, PROJECT-B) AND labels IN (feature)"
+     */
+    customQuery?: string;
+}
+/**
+ * Azure DevOps Configuration (Extended for Hierarchical Sync)
+ *
+ * Supports:
+ * - Simple strategy: Single project (project) - backward compatible
+ * - Filtered strategy: Multiple projects + area paths (containers) - NEW in v0.10.0
+ * - Custom strategy: Raw WIQL query (customQuery) - NEW in v0.10.0
+ *
+ * Backward Compatibility:
+ * - Old config: { organization, project, teams, areaPaths } - still works
+ * - New config: { organization, containers: [{id, filters: {areaPaths}}] } - hierarchical
+ */
+export interface AdoConfig {
+    organization: string;
+    /**
+     * @deprecated Use containers array instead
+     * Single project name
+     */
+    project?: string;
+    /**
+     * @deprecated Use filters in SyncContainer instead
+     * Teams within the project
+     */
+    teams?: string[];
+    /**
+     * @deprecated Use filters in SyncContainer instead
+     * Area paths per team
+     */
+    areaPaths?: Record<string, string>;
+    /**
+     * @deprecated Use filters in SyncContainer instead
+     */
+    iterationPath?: string;
+    workItemType?: 'Epic' | 'Feature' | 'User Story';
+    /**
+     * Filtered strategy: Multiple projects + area paths
+     * Example: [
+     *   {id: "Platform", filters: {areaPaths: ["Platform\\Core"], workItemTypes: ["User Story"]}},
+     *   {id: "Services", filters: {areaPaths: ["Services\\API"]}}
+     * ]
+     */
+    containers?: SyncContainer[];
+    /**
+     * Custom strategy: Raw WIQL query
+     * Example: "SELECT * FROM WorkItems WHERE [System.TeamProject] = 'Platform' AND [System.AreaPath] UNDER 'Platform\\Core'"
+     */
+    customQuery?: string;
+}
+export type ProviderConfig = GitHubConfig | JiraConfig | AdoConfig;
+export type TimeRangePreset = '1W' | '2W' | '1M' | '3M' | '6M' | '1Y' | 'ALL';
+export interface TimeRangeConfig {
+    /** Preset time range */
+    preset?: TimeRangePreset;
+    /** Custom date range */
+    custom?: {
+        start: string;
+        end?: string;
+    };
+}
+export interface TimeRangeEstimate {
+    /** Estimated work items to sync */
+    items: number;
+    /** Estimated API requests */
+    apiCalls: number;
+    /** Estimated sync duration in minutes */
+    durationMinutes: number;
+    /** Rate limit impact level */
+    rateLimitImpact: 'low' | 'medium' | 'high' | 'critical';
+}
+export interface RateLimitConfig {
+    /** Maximum items to sync in one operation */
+    maxItemsPerSync: number;
+    /** Warn user when exceeding this threshold */
+    warnThreshold: number;
+}
+export interface RateLimitStatus {
+    /** Remaining requests in current window */
+    remaining: number;
+    /** Total limit per window */
+    limit: number;
+    /** When the rate limit resets (ISO timestamp) */
+    resetAt: string;
+    /** Percentage of limit used */
+    percentUsed: number;
+}
+export interface ProviderRateLimits {
+    github: {
+        limit: 5000;
+        window: '1h';
+        thresholds: {
+            low: 250;
+            medium: 1000;
+            high: 2500;
+        };
+    };
+    jira: {
+        limit: 100;
+        window: '1m';
+        thresholds: {
+            low: 25;
+            medium: 50;
+            high: 75;
+        };
+    };
+    ado: {
+        limit: 200;
+        window: '5m';
+        thresholds: {
+            low: 50;
+            medium: 100;
+            high: 150;
+        };
+    };
+}
+export interface SyncProfile {
+    /** Provider type */
+    provider: SyncProvider;
+    /** Human-readable name */
+    displayName: string;
+    /** Optional description */
+    description?: string;
+    /**
+     * Sync strategy (v0.10.0+)
+     * - simple: One container (default, backward compatible)
+     * - filtered: Multiple containers + boards (NEW)
+     * - custom: Raw query (NEW)
+     *
+     * If not specified, defaults to 'simple' for backward compatibility
+     */
+    strategy?: SyncStrategy;
+    /** Provider-specific configuration */
+    config: ProviderConfig;
+    /** Time range configuration */
+    timeRange: {
+        /** Default time range for this profile */
+        default: TimeRangePreset;
+        /** Maximum allowed time range */
+        max: TimeRangePreset;
+    };
+    /** Rate limiting configuration */
+    rateLimits?: RateLimitConfig;
+    /** Project context (for smart detection) */
+    projectContext?: {
+        /** Project name (e.g., "SpecWeave", "Client A Mobile") */
+        name: string;
+        /** Project description */
+        description?: string;
+        /** Keywords for auto-detection */
+        keywords?: string[];
+        /** Team/organization name */
+        team?: string;
+    };
+}
+export interface SyncProfiles {
+    /** Active profile (default selection) */
+    activeProfile?: string;
+    /** All available profiles */
+    profiles: Record<string, SyncProfile>;
+}
+export interface IncrementSyncMetadata {
+    /** Which profile this increment uses */
+    profile: string;
+    /** External issue/work item number */
+    issueNumber?: number;
+    /** External issue/work item key (for JIRA) */
+    issueKey?: string;
+    /** Direct URL to external issue */
+    issueUrl?: string;
+    /** Time range used for this sync */
+    timeRange: TimeRangePreset | 'custom';
+    /** Custom time range (if timeRange === 'custom') */
+    customTimeRange?: {
+        start: string;
+        end?: string;
+    };
+    /** When sync was created */
+    createdAt: string;
+    /** Last successful sync timestamp */
+    lastSyncAt?: string;
+    /** Sync status */
+    status?: 'active' | 'paused' | 'failed' | 'completed';
+    /** Last sync error (if any) */
+    lastError?: {
+        message: string;
+        timestamp: string;
+        rateLimited?: boolean;
+    };
+}
+export interface ProjectContext {
+    /** Unique project identifier (kebab-case) */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Project description */
+    description: string;
+    /** Team/organization */
+    team?: string;
+    /** Keywords for auto-detection */
+    keywords: string[];
+    /** Default sync profile for this project */
+    defaultSyncProfile?: string;
+    /** Project-specific specs folder */
+    specsFolder: string;
+    /** Related increments (for tracking) */
+    increments?: string[];
+}
+export interface SyncConfiguration {
+    /** Active profile */
+    activeProfile?: string;
+    /** All sync profiles */
+    profiles: Record<string, SyncProfile>;
+    /** Project contexts */
+    projects?: Record<string, ProjectContext>;
+    /** Global settings */
+    settings?: {
+        /** Auto-detect project from increment description */
+        autoDetectProject?: boolean;
+        /** Default time range for new syncs */
+        defaultTimeRange?: TimeRangePreset;
+        /** Enable rate limit protection */
+        rateLimitProtection?: boolean;
+    };
+}
+export interface ProfileValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+export interface ProjectDetectionResult {
+    /** Matched project (if any) */
+    project?: ProjectContext;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Matched keywords */
+    matchedKeywords: string[];
+    /** Suggested sync profile */
+    suggestedProfile?: string;
+}
+/**
+ * Check if profile uses simple strategy (one container, backward compatible)
+ */
+export declare function isSimpleStrategy(profile: SyncProfile): boolean;
+/**
+ * Check if profile uses filtered strategy (multiple containers + boards)
+ */
+export declare function isFilteredStrategy(profile: SyncProfile): boolean;
+/**
+ * Check if profile uses custom strategy (raw query)
+ */
+export declare function isCustomStrategy(profile: SyncProfile): boolean;
+/**
+ * Check if config has hierarchical containers (Jira)
+ */
+export declare function hasJiraContainers(config: JiraConfig): boolean;
+/**
+ * Check if config has hierarchical containers (GitHub)
+ */
+export declare function hasGitHubContainers(config: GitHubConfig): boolean;
+/**
+ * Check if config has hierarchical containers (ADO)
+ */
+export declare function hasAdoContainers(config: AdoConfig): boolean;
+/**
+ * Get effective strategy (defaults to 'simple' if not specified)
+ */
+export declare function getEffectiveStrategy(profile: SyncProfile): SyncStrategy;
+//# sourceMappingURL=sync-profile.d.ts.map

package/dist/src/core/types/sync-profile.d.ts.map

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

package/dist/src/core/types/sync-profile.js

@@ -0,0 +1,55 @@
+/**
+ * Sync Profile Types for Multi-Project External Integration
+ *
+ * Supports multiple projects per provider (GitHub, JIRA, ADO, etc.)
+ * with time range filtering and rate limiting protection.
+ */
+// ============================================================================
+// Type Guard Functions (v0.10.0+)
+// ============================================================================
+/**
+ * Check if profile uses simple strategy (one container, backward compatible)
+ */
+export function isSimpleStrategy(profile) {
+    // If strategy not specified, default to simple (backward compatibility)
+    if (!profile.strategy)
+        return true;
+    return profile.strategy === 'simple';
+}
+/**
+ * Check if profile uses filtered strategy (multiple containers + boards)
+ */
+export function isFilteredStrategy(profile) {
+    return profile.strategy === 'filtered';
+}
+/**
+ * Check if profile uses custom strategy (raw query)
+ */
+export function isCustomStrategy(profile) {
+    return profile.strategy === 'custom';
+}
+/**
+ * Check if config has hierarchical containers (Jira)
+ */
+export function hasJiraContainers(config) {
+    return !!(config.containers && config.containers.length > 0);
+}
+/**
+ * Check if config has hierarchical containers (GitHub)
+ */
+export function hasGitHubContainers(config) {
+    return !!(config.containers && config.containers.length > 0);
+}
+/**
+ * Check if config has hierarchical containers (ADO)
+ */
+export function hasAdoContainers(config) {
+    return !!(config.containers && config.containers.length > 0);
+}
+/**
+ * Get effective strategy (defaults to 'simple' if not specified)
+ */
+export function getEffectiveStrategy(profile) {
+    return profile.strategy || 'simple';
+}
+//# sourceMappingURL=sync-profile.js.map

package/dist/src/core/types/sync-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-profile.js","sourceRoot":"","sources":["../../../../src/core/types/sync-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwgBH,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,wEAAwE;IACxE,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACrD,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoB;IACvD,OAAO,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;AACtC,CAAC"}

package/dist/src/hooks/lib/git-diff-analyzer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Git Diff Analyzer
+ *
+ * Extracts modified files from git diff for reflection analysis
+ * Parses git diff output to get file changes, line counts, and content
+ *
+ * @module git-diff-analyzer
+ */
+import { GitDiffInfo } from './types/reflection-types';
+/**
+ * Check if directory is a git repository
+ * @param dir Directory to check (defaults to cwd)
+ * @returns True if directory is in a git repository
+ */
+export declare function isGitRepository(dir?: string): boolean;
+/**
+ * Get list of modified files in the working directory
+ * Includes both staged and unstaged changes
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @returns Array of file paths relative to git root
+ */
+export declare function getModifiedFilesList(cwd?: string): string[];
+/**
+ * Parse git diff numstat output to get line counts
+ * Format: <added>\t<removed>\t<filename>
+ *
+ * @param numstatOutput Output from git diff --numstat
+ * @returns Map of filename to {added, removed} counts
+ */
+export declare function parseNumstat(numstatOutput: string): Map<string, {
+    added: number;
+    removed: number;
+}>;
+/**
+ * Get diff content for a specific file
+ * @param file File path relative to git root
+ * @param cwd Working directory (optional)
+ * @returns Diff content as string
+ */
+export declare function getFileDiff(file: string, cwd?: string): string;
+/**
+ * Get current file content
+ * @param file File path (can be absolute or relative to cwd)
+ * @param cwd Working directory (optional)
+ * @returns File content as string, or empty string if file doesn't exist
+ */
+export declare function getFileContent(file: string, cwd?: string): string;
+/**
+ * Get modified files with diff information
+ * Main function for reflection analysis
+ *
+ * @param cwd Working directory (optional, defaults to process.cwd())
+ * @param maxFiles Maximum number of files to return (optional, defaults to 100)
+ * @returns Array of GitDiffInfo objects with file changes
+ */
+export declare function getModifiedFiles(cwd?: string, maxFiles?: number): GitDiffInfo[];
+/**
+ * Get summary statistics for modified files
+ * Useful for reflection metadata
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @returns Summary with file count, total lines added/removed
+ */
+export declare function getModifiedFilesSummary(modifiedFiles: GitDiffInfo[]): {
+    count: number;
+    linesAdded: number;
+    linesRemoved: number;
+    totalChanges: number;
+};
+/**
+ * Filter files by extension
+ * Useful for focusing reflection on specific file types
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param extensions Array of file extensions (e.g., ['.ts', '.js'])
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export declare function filterFilesByExtension(modifiedFiles: GitDiffInfo[], extensions: string[]): GitDiffInfo[];
+/**
+ * Exclude files matching patterns
+ * Useful for excluding generated files, test files, etc.
+ *
+ * @param modifiedFiles Array of GitDiffInfo objects
+ * @param patterns Array of glob patterns to exclude
+ * @returns Filtered array of GitDiffInfo objects
+ */
+export declare function excludeFilesByPattern(modifiedFiles: GitDiffInfo[], patterns: string[]): GitDiffInfo[];
+//# sourceMappingURL=git-diff-analyzer.d.ts.map

package/dist/src/hooks/lib/git-diff-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff-analyzer.d.ts","sourceRoot":"","sources":["../../../../src/hooks/lib/git-diff-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAqBvD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAOpE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBnG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAajE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAY,GACrB,WAAW,EAAE,CA8Cf;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAUA;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,WAAW,EAAE,EAC5B,UAAU,EAAE,MAAM,EAAE,GACnB,WAAW,EAAE,CAKf;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,WAAW,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAAE,GACjB,WAAW,EAAE,CAQf"}