specweave 2.2.3 → 3.0.0

package/dist/src/core/status-line-validator.js

@@ -1,253 +0,0 @@
-/**
- * Status Line Validator
- *
- * Detects and reports when status line cache is out of sync with tasks.md.
- *
- * Critical for ensuring status line always reflects reality.
- */
-import * as fs from '../utils/fs-native.js';
-import path from 'path';
-import { consoleLogger } from '../utils/logger.js';
-export class StatusLineValidator {
-    constructor(options = {}) {
-        this.logger = options.logger ?? consoleLogger;
-    }
-    /**
-     * Validate status line for a specific increment
-     */
-    async validateIncrement(projectRoot, incrementId) {
-        const issues = [];
-        // Read tasks.md
-        const tasksPath = path.join(projectRoot, '.specweave', 'increments', incrementId, 'tasks.md');
-        if (!await fs.pathExists(tasksPath)) {
-            throw new Error(`tasks.md not found: ${tasksPath}`);
-        }
-        const tasksContent = await fs.readFile(tasksPath, 'utf-8');
-        // Count actual task completions
-        const actual = this.countActualCompletions(tasksContent);
-        // Parse frontmatter
-        const frontmatter = this.parseFrontmatter(tasksContent);
-        // Read status line cache
-        const cachePath = path.join(projectRoot, '.specweave', 'state', 'status-line.json');
-        const cache = await this.readCache(cachePath, incrementId);
-        // Validate consistency
-        if (actual.completedTasks !== frontmatter.completedTasks) {
-            issues.push(`Frontmatter desync: actual=${actual.completedTasks}, frontmatter=${frontmatter.completedTasks}`);
-        }
-        if (actual.totalTasks !== frontmatter.totalTasks) {
-            issues.push(`Total tasks mismatch: actual=${actual.totalTasks}, frontmatter=${frontmatter.totalTasks}`);
-        }
-        // Only validate cache if this is the current increment
-        // Status line cache only stores ONE current increment at a time
-        const isCurrentIncrement = cache.completedTasks > 0 || cache.totalTasks > 0;
-        if (isCurrentIncrement) {
-            if (actual.completedTasks !== cache.completedTasks) {
-                issues.push(`Cache desync: actual=${actual.completedTasks}, cache=${cache.completedTasks}`);
-            }
-            if (actual.percentage !== cache.percentage) {
-                issues.push(`Percentage desync: actual=${actual.percentage}%, cache=${cache.percentage}%`);
-            }
-        }
-        // Check cache staleness (> 24 hours old) - only for current increment
-        if (isCurrentIncrement) {
-            const cacheAge = Date.now() - new Date(cache.lastUpdate).getTime();
-            const hoursSinceUpdate = cacheAge / (1000 * 60 * 60);
-            if (hoursSinceUpdate > 24) {
-                issues.push(`Cache stale: last updated ${Math.round(hoursSinceUpdate)} hours ago`);
-            }
-        }
-        return {
-            isValid: issues.length === 0,
-            incrementId,
-            actual,
-            frontmatter,
-            cache,
-            issues
-        };
-    }
-    /**
-     * Validate all active increments
-     */
-    async validateAll(projectRoot) {
-        const incrementsDir = path.join(projectRoot, '.specweave', 'increments');
-        if (!await fs.pathExists(incrementsDir)) {
-            return [];
-        }
-        const results = [];
-        const entries = await fs.readdir(incrementsDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isDirectory())
-                continue;
-            const specPath = path.join(incrementsDir, entry.name, 'spec.md');
-            if (!await fs.pathExists(specPath))
-                continue;
-            const specContent = await fs.readFile(specPath, 'utf-8');
-            const statusMatch = specContent.match(/^status:\s*(\w+)/m);
-            const status = statusMatch ? statusMatch[1] : null;
-            // Only validate active/planning increments
-            if (status === 'active' || status === 'planned' || status === 'planning') {
-                try {
-                    const result = await this.validateIncrement(projectRoot, entry.name);
-                    results.push(result);
-                }
-                catch (error) {
-                    this.logger.error(`Failed to validate ${entry.name}:`, error);
-                }
-            }
-        }
-        return results;
-    }
-    /**
-     * Count actual task completions by parsing tasks.md
-     */
-    countActualCompletions(content) {
-        const lines = content.split('\n');
-        // Count total tasks (### T- headings)
-        const totalTasks = lines.filter(line => /^###\s+T-\d+/.test(line)).length;
-        // Count completed tasks (multiple formats)
-        let completedTasks = 0;
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            // Check for task heading
-            if (/^###\s+T-\d+/.test(line)) {
-                // Look ahead for status line (within next 10 lines)
-                for (let j = i + 1; j < Math.min(i + 10, lines.length); j++) {
-                    const statusLine = lines[j];
-                    // Format 1: **Status**: [x] completed
-                    if (/\*\*Status\*\*:\s*\[x\]\s*completed/i.test(statusLine)) {
-                        completedTasks++;
-                        break;
-                    }
-                    // Format 2: ✅ COMPLETE in task title
-                    if (line.includes('✅ COMPLETE')) {
-                        completedTasks++;
-                        break;
-                    }
-                    // Stop at next task or section
-                    if (/^###\s+T-\d+/.test(statusLine) || /^##\s+/.test(statusLine)) {
-                        break;
-                    }
-                }
-            }
-        }
-        const percentage = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
-        return { completedTasks, totalTasks, percentage };
-    }
-    /**
-     * Parse frontmatter from tasks.md
-     */
-    parseFrontmatter(content) {
-        const completedMatch = content.match(/^completed:\s*(\d+)/m);
-        const totalMatch = content.match(/^total_tasks:\s*(\d+)/m);
-        return {
-            completedTasks: completedMatch ? parseInt(completedMatch[1], 10) : 0,
-            totalTasks: totalMatch ? parseInt(totalMatch[1], 10) : 0
-        };
-    }
-    /**
-     * Read status line cache
-     */
-    async readCache(cachePath, incrementId) {
-        if (!await fs.pathExists(cachePath)) {
-            return {
-                completedTasks: 0,
-                totalTasks: 0,
-                percentage: 0,
-                lastUpdate: new Date(0).toISOString()
-            };
-        }
-        const cache = await fs.readJson(cachePath);
-        if (!cache.current || cache.current.id !== incrementId) {
-            return {
-                completedTasks: 0,
-                totalTasks: 0,
-                percentage: 0,
-                lastUpdate: cache.lastUpdate || new Date(0).toISOString()
-            };
-        }
-        return {
-            completedTasks: cache.current.completed || 0,
-            totalTasks: cache.current.total || 0,
-            percentage: cache.current.percentage || 0,
-            lastUpdate: cache.lastUpdate || new Date(0).toISOString()
-        };
-    }
-    /**
-     * Generate validation report
-     */
-    generateReport(results) {
-        const lines = [];
-        lines.push('# Status Line Validation Report');
-        lines.push('');
-        lines.push(`Generated: ${new Date().toISOString()}`);
-        lines.push('');
-        const validCount = results.filter(r => r.isValid).length;
-        const invalidCount = results.filter(r => !r.isValid).length;
-        lines.push(`## Summary`);
-        lines.push('');
-        lines.push(`- Total increments checked: ${results.length}`);
-        lines.push(`- Valid: ${validCount}`);
-        lines.push(`- Invalid: ${invalidCount}`);
-        lines.push('');
-        if (invalidCount > 0) {
-            lines.push('## Issues Found');
-            lines.push('');
-            for (const result of results) {
-                if (!result.isValid) {
-                    lines.push(`### ${result.incrementId}`);
-                    lines.push('');
-                    lines.push('| Metric | Actual | Frontmatter | Cache |');
-                    lines.push('|--------|--------|-------------|-------|');
-                    lines.push(`| Completed | ${result.actual.completedTasks} | ${result.frontmatter.completedTasks} | ${result.cache.completedTasks} |`);
-                    lines.push(`| Total | ${result.actual.totalTasks} | ${result.frontmatter.totalTasks} | ${result.cache.totalTasks} |`);
-                    lines.push(`| Percentage | ${result.actual.percentage}% | - | ${result.cache.percentage}% |`);
-                    lines.push('');
-                    lines.push('**Issues:**');
-                    for (const issue of result.issues) {
-                        lines.push(`- ${issue}`);
-                    }
-                    lines.push('');
-                }
-            }
-        }
-        else {
-            lines.push('## All Status Lines Valid ✅');
-            lines.push('');
-            lines.push('No desynchronization detected.');
-        }
-        return lines.join('\n');
-    }
-}
-/**
- * CLI entry point for validation
- */
-export async function main() {
-    const validator = new StatusLineValidator();
-    const projectRoot = process.cwd();
-    console.log('🔍 Validating status line synchronization...\n');
-    const results = await validator.validateAll(projectRoot);
-    if (results.length === 0) {
-        console.log('ℹ️  No active increments found.');
-        process.exit(0);
-    }
-    const report = validator.generateReport(results);
-    console.log(report);
-    const hasIssues = results.some(r => !r.isValid);
-    if (hasIssues) {
-        console.log('\n❌ Validation failed! Status line is out of sync.');
-        console.log('Run: specweave status-line --clear   (then reopen the increment to rebuild it)');
-        process.exit(1);
-    }
-    else {
-        console.log('\n✅ All status lines valid!');
-        process.exit(0);
-    }
-}
-// Run if executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-    main().catch(error => {
-        console.error('Fatal error:', error);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=status-line-validator.js.map

package/dist/src/core/status-line-validator.js.map

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

package/dist/src/core/sync/external-tool-resolver.d.ts

@@ -1,176 +0,0 @@
-/**
- * External Tool Resolver Service (v1.0.31+ - ADR-0211)
- *
- * Single source of truth for external tool selection.
- * Resolves which sync profile an increment should use based on:
- * 1. Explicit syncTarget in metadata (highest priority)
- * 2. Project mapping from spec.md **Project**: field
- * 3. Default profile from config (fallback)
- *
- * @module core/sync/external-tool-resolver
- */
-import { SyncTarget, SyncTargetDerivation, ExternalToolValidationResult } from '../types/increment-metadata.js';
-import { SyncProfile, SyncProvider } from '../types/sync-profile.js';
-import { Logger } from '../../utils/logger.js';
-/**
- * Project mapping configuration (from config.json)
- * Maps SpecWeave project IDs to external tool targets
- */
-export interface ProjectMapping {
-    github?: {
-        owner: string;
-        repo: string;
-        profileId?: string;
-    };
-    jira?: {
-        project: string;
-        board?: string;
-        profileId?: string;
-    };
-    ado?: {
-        project: string;
-        areaPath?: string;
-        profileId?: string;
-    };
-}
-export interface ProjectMappings {
-    [projectId: string]: ProjectMapping;
-}
-/**
- * Resolution result with full context
- */
-export interface ResolutionResult {
-    /** Resolved sync target */
-    syncTarget: SyncTarget | null;
-    /** Full profile configuration (if resolved) */
-    profile: SyncProfile | null;
-    /** Resolution path for debugging */
-    resolutionPath: string[];
-    /** Any warnings during resolution */
-    warnings: string[];
-}
-/**
- * External Tool Resolver
- *
- * Provides unified external tool selection logic.
- * Use this service instead of scattered logic throughout the codebase.
- */
-export declare class ExternalToolResolver {
-    private projectRoot;
-    private configPath;
-    private config;
-    private logger;
-    constructor(projectRoot: string, options?: {
-        logger?: Logger;
-    });
-    /**
-     * Load configuration from disk
-     */
-    private loadConfig;
-    /**
-     * Get sync configuration
-     */
-    private getSyncConfig;
-    /**
-     * Get workspace configuration
-     */
-    private getWorkspaceConfig;
-    /**
-     * Convert WorkspaceRepoSync to ProjectMapping-compatible format for profile matching
-     */
-    private convertWorkspaceSyncToMapping;
-    /**
-     * Resolve external tool for an increment
-     *
-     * Resolution priority:
-     * 1. Explicit syncTarget in metadata
-     * 2. Project mapping from spec.md **Project**: field
-     * 3. Default profile from config
-     *
-     * @param incrementId - Increment ID (e.g., "0142-feature")
-     * @param projectId - Optional project ID from spec.md (for priority 2)
-     * @returns Resolution result with sync target and profile
-     */
-    resolveForIncrement(incrementId: string, projectId?: string): Promise<ResolutionResult>;
-    /**
-     * Resolve external tool for a specific project ID
-     *
-     * Looks up project in workspace.repos and resolves to a profile.
-     * Falls back to workspace.rootRepo when projectId matches workspace.name.
-     *
-     * @param projectId - SpecWeave project ID (e.g., "frontend-app")
-     * @returns Resolution result
-     */
-    resolveForProject(projectId: string): Promise<ResolutionResult>;
-    /**
-     * Resolve for a specific provider (e.g., "get me the GitHub profile")
-     *
-     * @param provider - Provider type
-     * @param projectId - Optional project ID for project-specific profile
-     * @returns Resolution result
-     */
-    resolveForProvider(provider: SyncProvider, projectId?: string): Promise<ResolutionResult>;
-    /**
-     * Validate external tool configuration for an increment
-     *
-     * Call this at increment start to fail fast if config is missing.
-     *
-     * @param incrementId - Increment ID
-     * @param projectId - Project ID from spec.md
-     * @returns Validation result
-     */
-    validateIncrementConfig(incrementId: string, projectId?: string): Promise<ExternalToolValidationResult>;
-    /**
-     * Validate profile configuration completeness
-     */
-    private validateProfileConfig;
-    /**
-     * Check if authentication is configured for a provider
-     */
-    private checkAuthentication;
-    /**
-     * Load increment metadata
-     */
-    private loadIncrementMetadata;
-    /**
-     * Get profile by ID
-     */
-    private getProfileById;
-    /**
-     * Find profile matching a project mapping
-     */
-    private findProfileByMapping;
-    /**
-     * Create a sync target for saving to metadata
-     *
-     * @param profileId - Profile ID
-     * @param provider - Provider type
-     * @param derivedFrom - How it was determined
-     * @param sourceProjectId - Optional source project
-     * @returns SyncTarget object
-     */
-    static createSyncTarget(profileId: string, provider: SyncProvider, derivedFrom: SyncTargetDerivation, sourceProjectId?: string): SyncTarget;
-    /**
-     * Check if any external tool is configured
-     */
-    hasExternalToolConfigured(): Promise<boolean>;
-    /**
-     * Get all configured providers
-     */
-    getConfiguredProviders(): Promise<SyncProvider[]>;
-    /**
-     * Get summary of external tool configuration
-     */
-    getConfigSummary(): Promise<{
-        hasConfig: boolean;
-        providers: SyncProvider[];
-        profileCount: number;
-        defaultProfile?: string;
-        projectMappingCount: number;
-    }>;
-}
-/**
- * Factory function for creating ExternalToolResolver
- */
-export declare function createExternalToolResolver(projectRoot: string, logger?: Logger): ExternalToolResolver;
-//# sourceMappingURL=external-tool-resolver.d.ts.map

package/dist/src/core/sync/external-tool-resolver.d.ts.map

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