specweave 0.28.68 → 0.29.1

package/dist/src/core/discrepancy/analyzers/typescript-analyzer.d.ts

@@ -0,0 +1,96 @@
+/**
+ * TypeScript Code Analyzer
+ *
+ * Extracts function signatures and type definitions from TypeScript files
+ * using the TypeScript Compiler API.
+ *
+ * @module core/discrepancy/analyzers/typescript-analyzer
+ */
+import { Logger } from '../../../utils/logger.js';
+/**
+ * Represents a function parameter with name and type.
+ */
+export interface FunctionParam {
+    name: string;
+    type: string;
+    optional: boolean;
+}
+/**
+ * Represents a function signature extracted from code.
+ */
+export interface FunctionSignature {
+    name: string;
+    filePath: string;
+    lineNumber: number;
+    params: FunctionParam[];
+    returnType: string;
+    exported: boolean;
+    async: boolean;
+    jsdoc?: string;
+}
+/**
+ * Represents a type definition (interface, type alias, or class).
+ */
+export interface TypeDefinition {
+    name: string;
+    filePath: string;
+    lineNumber: number;
+    kind: 'interface' | 'type' | 'class';
+    exported: boolean;
+    properties?: {
+        name: string;
+        type: string;
+        optional: boolean;
+    }[];
+}
+/**
+ * Configuration for the TypeScript analyzer.
+ */
+export interface TypeScriptAnalyzerConfig {
+    /** Glob patterns to include (default: ['**\/*.ts']) */
+    include?: string[];
+    /** Glob patterns to exclude (default: ['**\/*.test.ts', 'node_modules/**']) */
+    exclude?: string[];
+    /** Base directory for relative paths */
+    basePath?: string;
+}
+/**
+ * Result of TypeScript analysis.
+ */
+export interface AnalysisResult {
+    functions: FunctionSignature[];
+    types: TypeDefinition[];
+    errors: string[];
+}
+/**
+ * Analyzes TypeScript files to extract function signatures and type definitions.
+ */
+export declare class TypeScriptAnalyzer {
+    private readonly logger;
+    private readonly config;
+    constructor(options?: {
+        logger?: Logger;
+        config?: TypeScriptAnalyzerConfig;
+    });
+    /**
+     * Analyze a list of TypeScript files.
+     */
+    analyze(files: string[]): Promise<AnalysisResult>;
+    /**
+     * Analyze a single TypeScript file.
+     */
+    analyzeFile(filePath: string): Promise<AnalysisResult>;
+    private extractFunctionSignature;
+    private extractArrowFunctionSignature;
+    private extractMethodSignature;
+    private extractInterfaceDefinition;
+    private extractTypeAliasDefinition;
+    private extractClassDefinition;
+    private extractParameters;
+    private extractReturnType;
+    private extractInterfaceProperties;
+    private extractJSDoc;
+    private hasExportModifier;
+    private hasAsyncModifier;
+}
+//# sourceMappingURL=typescript-analyzer.d.ts.map

package/dist/src/core/discrepancy/analyzers/typescript-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-analyzer.d.ts","sourceRoot":"","sources":["../../../../../src/core/discrepancy/analyzers/typescript-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,MAAM,EAAiB,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAEhD,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,wBAAwB,CAAA;KAAO;IAShF;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBvD;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmF5D,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,6BAA6B;IAoBrC,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,0BAA0B;IAiBlC,OAAO,CAAC,0BAA0B;IAgBlC,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,0BAA0B;IAoBlC,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/src/core/discrepancy/analyzers/typescript-analyzer.js

@@ -0,0 +1,247 @@
+/**
+ * TypeScript Code Analyzer
+ *
+ * Extracts function signatures and type definitions from TypeScript files
+ * using the TypeScript Compiler API.
+ *
+ * @module core/discrepancy/analyzers/typescript-analyzer
+ */
+import * as ts from 'typescript';
+import * as fs from 'fs';
+import * as path from 'path';
+import { consoleLogger } from '../../../utils/logger.js';
+/**
+ * Analyzes TypeScript files to extract function signatures and type definitions.
+ */
+export class TypeScriptAnalyzer {
+    constructor(options = {}) {
+        this.logger = options.logger ?? consoleLogger;
+        this.config = {
+            include: options.config?.include ?? ['**/*.ts'],
+            exclude: options.config?.exclude ?? ['**/*.test.ts', '**/*.spec.ts', 'node_modules/**', 'dist/**'],
+            basePath: options.config?.basePath ?? process.cwd(),
+        };
+    }
+    /**
+     * Analyze a list of TypeScript files.
+     */
+    async analyze(files) {
+        const functions = [];
+        const types = [];
+        const errors = [];
+        for (const filePath of files) {
+            try {
+                const result = await this.analyzeFile(filePath);
+                functions.push(...result.functions);
+                types.push(...result.types);
+                errors.push(...result.errors);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                errors.push(`Failed to analyze ${filePath}: ${message}`);
+                this.logger.warn(`Failed to analyze ${filePath}: ${message}`);
+            }
+        }
+        return { functions, types, errors };
+    }
+    /**
+     * Analyze a single TypeScript file.
+     */
+    async analyzeFile(filePath) {
+        const functions = [];
+        const types = [];
+        const errors = [];
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.resolve(this.config.basePath, filePath);
+        if (!fs.existsSync(absolutePath)) {
+            errors.push(`File not found: ${absolutePath}`);
+            return { functions, types, errors };
+        }
+        const content = fs.readFileSync(absolutePath, 'utf-8');
+        const sourceFile = ts.createSourceFile(absolutePath, content, ts.ScriptTarget.Latest, true);
+        const visit = (node) => {
+            // Check for function declarations
+            if (ts.isFunctionDeclaration(node) && node.name) {
+                const sig = this.extractFunctionSignature(node, sourceFile, absolutePath);
+                if (sig)
+                    functions.push(sig);
+            }
+            // Check for arrow functions assigned to const/let
+            if (ts.isVariableStatement(node)) {
+                const exported = this.hasExportModifier(node);
+                for (const decl of node.declarationList.declarations) {
+                    if (ts.isIdentifier(decl.name) && decl.initializer) {
+                        if (ts.isArrowFunction(decl.initializer) || ts.isFunctionExpression(decl.initializer)) {
+                            const sig = this.extractArrowFunctionSignature(decl.name.text, decl.initializer, sourceFile, absolutePath, exported);
+                            if (sig)
+                                functions.push(sig);
+                        }
+                    }
+                }
+            }
+            // Check for method declarations in classes
+            if (ts.isMethodDeclaration(node) && node.name && ts.isIdentifier(node.name)) {
+                const parent = node.parent;
+                if (ts.isClassDeclaration(parent)) {
+                    const sig = this.extractMethodSignature(node, sourceFile, absolutePath, parent);
+                    if (sig)
+                        functions.push(sig);
+                }
+            }
+            // Check for interface declarations
+            if (ts.isInterfaceDeclaration(node)) {
+                const typeDef = this.extractInterfaceDefinition(node, sourceFile, absolutePath);
+                if (typeDef)
+                    types.push(typeDef);
+            }
+            // Check for type alias declarations
+            if (ts.isTypeAliasDeclaration(node)) {
+                const typeDef = this.extractTypeAliasDefinition(node, sourceFile, absolutePath);
+                if (typeDef)
+                    types.push(typeDef);
+            }
+            // Check for class declarations
+            if (ts.isClassDeclaration(node) && node.name) {
+                const typeDef = this.extractClassDefinition(node, sourceFile, absolutePath);
+                if (typeDef)
+                    types.push(typeDef);
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        return { functions, types, errors };
+    }
+    extractFunctionSignature(node, sourceFile, filePath) {
+        if (!node.name)
+            return null;
+        const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+        const exported = this.hasExportModifier(node);
+        const jsdoc = this.extractJSDoc(node, sourceFile);
+        return {
+            name: node.name.text,
+            filePath,
+            lineNumber: line + 1,
+            params: this.extractParameters(node.parameters, sourceFile),
+            returnType: this.extractReturnType(node, sourceFile),
+            exported,
+            async: this.hasAsyncModifier(node),
+            jsdoc,
+        };
+    }
+    extractArrowFunctionSignature(name, node, sourceFile, filePath, exported) {
+        const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+        return {
+            name,
+            filePath,
+            lineNumber: line + 1,
+            params: this.extractParameters(node.parameters, sourceFile),
+            returnType: this.extractReturnType(node, sourceFile),
+            exported,
+            async: this.hasAsyncModifier(node),
+        };
+    }
+    extractMethodSignature(node, sourceFile, filePath, classNode) {
+        if (!node.name || !ts.isIdentifier(node.name))
+            return null;
+        const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+        const className = classNode.name?.text ?? 'AnonymousClass';
+        const exported = this.hasExportModifier(classNode);
+        const jsdoc = this.extractJSDoc(node, sourceFile);
+        return {
+            name: `${className}.${node.name.text}`,
+            filePath,
+            lineNumber: line + 1,
+            params: this.extractParameters(node.parameters, sourceFile),
+            returnType: this.extractReturnType(node, sourceFile),
+            exported,
+            async: this.hasAsyncModifier(node),
+            jsdoc,
+        };
+    }
+    extractInterfaceDefinition(node, sourceFile, filePath) {
+        const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+        return {
+            name: node.name.text,
+            filePath,
+            lineNumber: line + 1,
+            kind: 'interface',
+            exported: this.hasExportModifier(node),
+            properties: this.extractInterfaceProperties(node, sourceFile),
+        };
+    }
+    extractTypeAliasDefinition(node, sourceFile, filePath) {
+        const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+        return {
+            name: node.name.text,
+            filePath,
+            lineNumber: line + 1,
+            kind: 'type',
+            exported: this.hasExportModifier(node),
+        };
+    }
+    extractClassDefinition(node, sourceFile, filePath) {
+        if (!node.name)
+            return null;
+        const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+        return {
+            name: node.name.text,
+            filePath,
+            lineNumber: line + 1,
+            kind: 'class',
+            exported: this.hasExportModifier(node),
+        };
+    }
+    extractParameters(params, sourceFile) {
+        return params.map((param) => {
+            const name = ts.isIdentifier(param.name) ? param.name.text : param.name.getText(sourceFile);
+            const type = param.type ? param.type.getText(sourceFile) : 'unknown';
+            const optional = !!param.questionToken || !!param.initializer;
+            return { name, type, optional };
+        });
+    }
+    extractReturnType(node, sourceFile) {
+        if (node.type) {
+            return node.type.getText(sourceFile);
+        }
+        return 'unknown';
+    }
+    extractInterfaceProperties(node, sourceFile) {
+        const properties = [];
+        for (const member of node.members) {
+            if (ts.isPropertySignature(member) && member.name) {
+                const name = ts.isIdentifier(member.name)
+                    ? member.name.text
+                    : member.name.getText(sourceFile);
+                const type = member.type ? member.type.getText(sourceFile) : 'unknown';
+                const optional = !!member.questionToken;
+                properties.push({ name, type, optional });
+            }
+        }
+        return properties;
+    }
+    extractJSDoc(node, sourceFile) {
+        const jsdocNodes = ts.getJSDocCommentsAndTags(node);
+        if (jsdocNodes.length === 0)
+            return undefined;
+        const comments = [];
+        for (const jsdoc of jsdocNodes) {
+            if (ts.isJSDoc(jsdoc) && jsdoc.comment) {
+                const comment = typeof jsdoc.comment === 'string'
+                    ? jsdoc.comment
+                    : jsdoc.comment.map(c => c.getText(sourceFile)).join('');
+                comments.push(comment);
+            }
+        }
+        return comments.length > 0 ? comments.join('\n') : undefined;
+    }
+    hasExportModifier(node) {
+        const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+        return modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+    }
+    hasAsyncModifier(node) {
+        const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+        return modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) ?? false;
+    }
+}
+//# sourceMappingURL=typescript-analyzer.js.map

package/dist/src/core/discrepancy/analyzers/typescript-analyzer.js.map

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

package/dist/src/core/discrepancy/brownfield-manager.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Brownfield Discrepancy Manager
+ *
+ * Manages persistent storage and lifecycle of brownfield discrepancies.
+ * Uses batched folder structure for scalability (supports 10,000+ discrepancies).
+ *
+ * @module core/discrepancy/brownfield-manager
+ */
+import { Logger } from '../../utils/logger.js';
+import { BrownfieldDiscrepancy, BrownfieldDiscrepancyCreate, BrownfieldDiscrepancyFilter, BrownfieldDiscrepancyResolution, BrownfieldDiscrepancyStats, BrownfieldDiscrepancyUpdate } from './brownfield-types.js';
+/**
+ * Manages brownfield discrepancies with persistent storage.
+ */
+export declare class BrownfieldDiscrepancyManager {
+    private readonly projectPath;
+    private readonly basePath;
+    private readonly logger;
+    private index;
+    constructor(projectPath: string, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Initialize folder structure if needed.
+     */
+    ensureFolderStructure(): Promise<void>;
+    /**
+     * Create a new discrepancy with auto-generated ID.
+     */
+    createDiscrepancy(data: BrownfieldDiscrepancyCreate): Promise<BrownfieldDiscrepancy>;
+    /**
+     * Get a discrepancy by ID.
+     */
+    getDiscrepancy(id: string): Promise<BrownfieldDiscrepancy | null>;
+    /**
+     * Update a discrepancy.
+     */
+    updateDiscrepancy(id: string, updates: BrownfieldDiscrepancyUpdate): Promise<BrownfieldDiscrepancy | null>;
+    /**
+     * Delete a discrepancy.
+     */
+    deleteDiscrepancy(id: string): Promise<boolean>;
+    /**
+     * List discrepancies with optional filtering.
+     */
+    listDiscrepancies(filter?: BrownfieldDiscrepancyFilter): Promise<BrownfieldDiscrepancy[]>;
+    /**
+     * Get summary statistics.
+     */
+    getStats(): Promise<BrownfieldDiscrepancyStats>;
+    /**
+     * Link discrepancy to an increment.
+     * Returns true if successfully linked, false if discrepancy not found.
+     */
+    linkToIncrement(discrepancyId: string, incrementId: string): Promise<boolean>;
+    /**
+     * Resolve a discrepancy.
+     */
+    resolveDiscrepancy(id: string, resolution: BrownfieldDiscrepancyResolution): Promise<void>;
+    /**
+     * Ignore a discrepancy.
+     */
+    ignoreDiscrepancy(id: string, reason: string): Promise<void>;
+    /**
+     * Create multiple discrepancies in batch.
+     */
+    createBatch(discrepancies: BrownfieldDiscrepancyCreate[]): Promise<BrownfieldDiscrepancy[]>;
+    /**
+     * Archive resolved discrepancies to YYYY-MM folders.
+     */
+    archiveResolved(): Promise<number>;
+    /**
+     * Get the batch folder name for a numeric ID.
+     * Example: 1-100 → "0001-0100", 101-200 → "0101-0200"
+     */
+    getBatchFolder(numericId: number): string;
+    private getNextId;
+    private getStatusFolder;
+    private saveDiscrepancy;
+    private moveDiscrepancy;
+    private findDiscrepancyPath;
+    private readDiscrepancyFile;
+    private getAllJsonFiles;
+    private matchesFilter;
+    private loadIndex;
+    private saveIndex;
+    private updateIndex;
+}
+//# sourceMappingURL=brownfield-manager.d.ts.map

package/dist/src/core/discrepancy/brownfield-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brownfield-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/discrepancy/brownfield-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAE3B,+BAA+B,EAC/B,0BAA0B,EAG1B,2BAA2B,EAE5B,MAAM,uBAAuB,CAAC;AAgC/B;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAA2C;gBAGtD,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAOnC;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5C;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgB1F;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAevE;;OAEG;IACG,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IA0BxC;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBrD;;OAEG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAoE/F;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAKrD;;;OAGG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnF;;OAEG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,+BAA+B,GAC1C,OAAO,CAAC,IAAI,CAAC;IAOhB;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE;;OAEG;IACG,WAAW,CACf,aAAa,EAAE,2BAA2B,EAAE,GAC3C,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAWnC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IA4CxC;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;YAU3B,SAAS;IAMvB,OAAO,CAAC,eAAe;YAUT,eAAe;YAaf,eAAe;YAuCf,mBAAmB;IAkCjC,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,aAAa;YAiBP,SAAS;YAiBT,SAAS;YAWT,WAAW;CA4D1B"}