agent-bober 0.7.0 → 0.8.1

package/dist/discovery/scanners/code-conventions.js

@@ -0,0 +1,216 @@
+/**
+ * Scanner: Code Conventions
+ *
+ * Samples up to 20 source files per file category and detects:
+ * - File naming patterns (camelCase / kebab-case / PascalCase / snake_case)
+ * - Import style (relative vs absolute/alias, .js extensions)
+ * - Export patterns (named vs default)
+ * - TypeScript patterns (any, ts-ignore, enum, interface, type)
+ */
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+import { glob } from "glob";
+// ── Constants ─────────────────────────────────────────────────────
+/** Directories to skip when scanning. */
+const IGNORE_DIRS = [
+    "node_modules",
+    "dist",
+    ".git",
+    ".bober",
+    "build",
+    "coverage",
+    ".next",
+    "__pycache__",
+    ".turbo",
+    ".cache",
+    "out",
+    ".vercel",
+];
+const MAX_FILES_PER_CATEGORY = 20;
+// ── File naming detection ─────────────────────────────────────────
+const KEBAB_CASE_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)+$/;
+const PASCAL_CASE_RE = /^[A-Z][a-zA-Z0-9]*$/;
+const CAMEL_CASE_RE = /^[a-z][a-zA-Z0-9]*$/;
+const SNAKE_CASE_RE = /^[a-z][a-z0-9]*(_[a-z0-9]+)+$/;
+function detectFileNaming(name) {
+    if (KEBAB_CASE_RE.test(name))
+        return "kebab-case";
+    if (PASCAL_CASE_RE.test(name))
+        return "PascalCase";
+    if (SNAKE_CASE_RE.test(name))
+        return "snake_case";
+    if (CAMEL_CASE_RE.test(name))
+        return "camelCase";
+    return "mixed";
+}
+function analyzeFileNaming(filePaths) {
+    const counts = {
+        camelCase: 0,
+        "kebab-case": 0,
+        PascalCase: 0,
+        snake_case: 0,
+        mixed: 0,
+    };
+    for (const filePath of filePaths) {
+        const name = basename(filePath, extname(filePath));
+        // Remove test suffixes for more accurate naming analysis
+        const cleanName = name.replace(/\.(test|spec)$/, "");
+        // Also handle multi-dot names like "foo.test"
+        const baseName = cleanName.split(".")[0] ?? cleanName;
+        if (baseName) {
+            const style = detectFileNaming(baseName);
+            counts[style]++;
+        }
+    }
+    // Find dominant style (excluding "mixed")
+    let dominant = "mixed";
+    let maxCount = 0;
+    for (const [style, count] of Object.entries(counts)) {
+        if (style !== "mixed" && count > maxCount) {
+            dominant = style;
+            maxCount = count;
+        }
+    }
+    return { dominant, counts };
+}
+// ── Import style detection ────────────────────────────────────────
+const RELATIVE_RE = /^\.\.?\//;
+const JS_EXT_RE = /\.js['"]?\s*$/;
+function analyzeImportStyle(contents) {
+    let relativeCount = 0;
+    let absoluteCount = 0;
+    let jsExtCount = 0;
+    let totalImports = 0;
+    const examples = [];
+    for (const content of contents) {
+        const importLines = content.match(/^import\s+.+$/gm) ?? [];
+        for (const line of importLines) {
+            const match = /from\s+['"]([^'"]+)['"]/.exec(line);
+            if (!match)
+                continue;
+            const importPath = match[1];
+            if (!importPath)
+                continue;
+            totalImports++;
+            if (RELATIVE_RE.test(importPath)) {
+                relativeCount++;
+            }
+            else {
+                absoluteCount++;
+            }
+            if (JS_EXT_RE.test(importPath)) {
+                jsExtCount++;
+            }
+            if (examples.length < 5) {
+                examples.push(line.trim());
+            }
+        }
+    }
+    return {
+        relativeCount,
+        absoluteCount,
+        usesJsExtensions: totalImports > 0 && jsExtCount / totalImports >= 0.3,
+        examples,
+    };
+}
+// ── Export style detection ────────────────────────────────────────
+const NAMED_EXPORT_RE = /^export\s+(const|function|class|interface|type|enum|let|var)\s/gm;
+const DEFAULT_EXPORT_RE = /^export\s+default\s/gm;
+function analyzeExportStyle(contents) {
+    let namedExportCount = 0;
+    let defaultExportCount = 0;
+    for (const content of contents) {
+        const named = content.match(NAMED_EXPORT_RE);
+        const defaults = content.match(DEFAULT_EXPORT_RE);
+        namedExportCount += named?.length ?? 0;
+        defaultExportCount += defaults?.length ?? 0;
+    }
+    let dominant;
+    const total = namedExportCount + defaultExportCount;
+    if (total === 0) {
+        dominant = "mixed";
+    }
+    else if (namedExportCount / total >= 0.7) {
+        dominant = "named";
+    }
+    else if (defaultExportCount / total >= 0.7) {
+        dominant = "default";
+    }
+    else {
+        dominant = "mixed";
+    }
+    return { namedExportCount, defaultExportCount, dominant };
+}
+// ── TypeScript patterns detection ─────────────────────────────────
+function analyzeTypeScriptPatterns(contents) {
+    let anyCount = 0;
+    let tsIgnoreCount = 0;
+    let enumCount = 0;
+    let interfaceCount = 0;
+    let typeAliasCount = 0;
+    for (const content of contents) {
+        // Count `: any` usages (avoid counting "anyCount" variable names etc)
+        const anyMatches = content.match(/:\s*any[\s;,)>]/g);
+        anyCount += anyMatches?.length ?? 0;
+        const tsIgnoreMatches = content.match(/@ts-(ignore|expect-error)/g);
+        tsIgnoreCount += tsIgnoreMatches?.length ?? 0;
+        const enumMatches = content.match(/\benum\s+\w+/g);
+        enumCount += enumMatches?.length ?? 0;
+        const interfaceMatches = content.match(/\binterface\s+\w+/g);
+        interfaceCount += interfaceMatches?.length ?? 0;
+        const typeAliasMatches = content.match(/\btype\s+\w+\s*=/g);
+        typeAliasCount += typeAliasMatches?.length ?? 0;
+    }
+    return { anyCount, tsIgnoreCount, enumCount, interfaceCount, typeAliasCount };
+}
+// ── Main scanner ──────────────────────────────────────────────────
+export async function scanCodeConventions(projectRoot) {
+    const ignore = IGNORE_DIRS.map((d) => `**/${d}/**`);
+    // Gather TypeScript/JavaScript files
+    let tsFiles;
+    let jsFiles;
+    try {
+        tsFiles = await glob("**/*.{ts,tsx}", {
+            cwd: projectRoot,
+            ignore,
+            absolute: true,
+        });
+        jsFiles = await glob("**/*.{js,jsx}", {
+            cwd: projectRoot,
+            ignore,
+            absolute: true,
+        });
+    }
+    catch {
+        return null;
+    }
+    // Exclude test files from naming analysis (but include in content analysis)
+    const sourceFiles = [...tsFiles, ...jsFiles]
+        .sort()
+        .slice(0, MAX_FILES_PER_CATEGORY * 2);
+    if (sourceFiles.length === 0) {
+        return null;
+    }
+    // Read file contents
+    const contents = [];
+    for (const filePath of sourceFiles.slice(0, MAX_FILES_PER_CATEGORY * 2)) {
+        try {
+            const content = await readFile(filePath, "utf-8");
+            contents.push(content);
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    const isTypeScript = tsFiles.length > 0;
+    return {
+        filesSampled: sourceFiles.length,
+        fileNaming: analyzeFileNaming(sourceFiles),
+        importStyle: analyzeImportStyle(contents),
+        exportStyle: analyzeExportStyle(contents),
+        typescriptPatterns: isTypeScript
+            ? analyzeTypeScriptPatterns(contents)
+            : null,
+    };
+}
+//# sourceMappingURL=code-conventions.js.map

package/dist/discovery/scanners/code-conventions.js.map

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

package/dist/discovery/scanners/documentation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Scanner: Documentation
+ *
+ * Reads key documentation files from the project root and stores
+ * their content truncated to 2000 characters each.
+ *
+ * Files scanned:
+ * - README.md
+ * - CONTRIBUTING.md
+ * - CLAUDE.md
+ * - .cursorrules
+ * - .github/PULL_REQUEST_TEMPLATE.md
+ * - docs/**\/*.md
+ */
+import type { DocumentationReport } from "../types.js";
+export declare function scanDocumentation(projectRoot: string): Promise<DocumentationReport>;
+//# sourceMappingURL=documentation.d.ts.map

package/dist/discovery/scanners/documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.d.ts","sourceRoot":"","sources":["../../../src/discovery/scanners/documentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAW,MAAM,aAAa,CAAC;AAyChE,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}

package/dist/discovery/scanners/documentation.js

@@ -0,0 +1,92 @@
+/**
+ * Scanner: Documentation
+ *
+ * Reads key documentation files from the project root and stores
+ * their content truncated to 2000 characters each.
+ *
+ * Files scanned:
+ * - README.md
+ * - CONTRIBUTING.md
+ * - CLAUDE.md
+ * - .cursorrules
+ * - .github/PULL_REQUEST_TEMPLATE.md
+ * - docs/**\/*.md
+ */
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { glob } from "glob";
+import { fileExists } from "../../utils/fs.js";
+// ── Constants ─────────────────────────────────────────────────────
+const MAX_CONTENT_LENGTH = 2000;
+/** Fixed documentation files to always attempt reading. */
+const FIXED_DOC_FILES = [
+    "README.md",
+    "CONTRIBUTING.md",
+    "CLAUDE.md",
+    ".cursorrules",
+    ".github/PULL_REQUEST_TEMPLATE.md",
+];
+// ── Helpers ───────────────────────────────────────────────────────
+async function readDocFile(projectRoot, relPath) {
+    const fullPath = join(projectRoot, relPath);
+    if (!(await fileExists(fullPath))) {
+        return null;
+    }
+    try {
+        const raw = await readFile(fullPath, "utf-8");
+        const truncated = raw.length > MAX_CONTENT_LENGTH;
+        return {
+            path: relPath,
+            content: truncated ? raw.slice(0, MAX_CONTENT_LENGTH) : raw,
+            truncated,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ── Main scanner ──────────────────────────────────────────────────
+export async function scanDocumentation(projectRoot) {
+    const files = [];
+    const seenPaths = new Set();
+    // Read fixed doc files first
+    for (const relPath of FIXED_DOC_FILES) {
+        const docFile = await readDocFile(projectRoot, relPath);
+        if (docFile) {
+            files.push(docFile);
+            seenPaths.add(relPath);
+        }
+    }
+    // Scan docs/**/*.md
+    try {
+        const docsGlob = await glob("docs/**/*.md", {
+            cwd: projectRoot,
+            absolute: true,
+        });
+        // Sort alphabetically for deterministic ordering
+        const sortedDocs = docsGlob.sort();
+        for (const fullPath of sortedDocs) {
+            const relPath = relative(projectRoot, fullPath);
+            if (seenPaths.has(relPath))
+                continue;
+            try {
+                const raw = await readFile(fullPath, "utf-8");
+                const truncated = raw.length > MAX_CONTENT_LENGTH;
+                files.push({
+                    path: relPath,
+                    content: truncated ? raw.slice(0, MAX_CONTENT_LENGTH) : raw,
+                    truncated,
+                });
+                seenPaths.add(relPath);
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    catch {
+        // docs/ directory may not exist — that's fine
+    }
+    return { files };
+}
+//# sourceMappingURL=documentation.js.map

package/dist/discovery/scanners/documentation.js.map

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

package/dist/discovery/scanners/git-conventions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Scanner: Git Conventions
+ *
+ * Analyzes git history and branches to detect:
+ * - Commit message format (conventional commits, custom prefixes)
+ * - Branch naming patterns
+ * - Merge strategy
+ */
+import type { GitConventionsReport } from "../types.js";
+export declare function scanGitConventions(projectRoot: string): Promise<GitConventionsReport | null>;
+//# sourceMappingURL=git-conventions.d.ts.map

package/dist/discovery/scanners/git-conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-conventions.d.ts","sourceRoot":"","sources":["../../../src/discovery/scanners/git-conventions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA8ExD,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkEtC"}

package/dist/discovery/scanners/git-conventions.js

@@ -0,0 +1,128 @@
+/**
+ * Scanner: Git Conventions
+ *
+ * Analyzes git history and branches to detect:
+ * - Commit message format (conventional commits, custom prefixes)
+ * - Branch naming patterns
+ * - Merge strategy
+ */
+import { join } from "node:path";
+import { execa } from "execa";
+import { fileExists } from "../../utils/fs.js";
+// ── Commit message analysis ───────────────────────────────────────
+const CONVENTIONAL_COMMIT_RE = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?:/i;
+const MERGE_COMMIT_RE = /^Merge (branch|pull request|remote)/i;
+/**
+ * Extracts the prefix/type from a commit message.
+ * Returns e.g. "feat:", "bober(sprint-1):", "JIRA-123:".
+ */
+function extractPrefix(message) {
+    // Conventional commits: feat(scope): or feat:
+    const conventional = /^[a-zA-Z]+(\([^)]+\))?:/.exec(message);
+    if (conventional)
+        return conventional[0];
+    // Ticket prefix: JIRA-123, ABC-456
+    const ticket = /^[A-Z]+-\d+/.exec(message);
+    if (ticket)
+        return ticket[0];
+    return null;
+}
+function detectMostCommonPrefix(messages) {
+    const prefixCounts = new Map();
+    for (const msg of messages) {
+        const prefix = extractPrefix(msg);
+        if (prefix) {
+            prefixCounts.set(prefix, (prefixCounts.get(prefix) ?? 0) + 1);
+        }
+    }
+    if (prefixCounts.size === 0)
+        return null;
+    let topPrefix = "";
+    let topCount = 0;
+    for (const [prefix, count] of prefixCounts) {
+        if (count > topCount) {
+            topPrefix = prefix;
+            topCount = count;
+        }
+    }
+    return topPrefix || null;
+}
+// ── Branch pattern analysis ───────────────────────────────────────
+/**
+ * Groups branch names into patterns like "feature/*", "bober/*", etc.
+ */
+function detectBranchPatterns(branches) {
+    const prefixCounts = new Map();
+    for (const branch of branches) {
+        // Strip remote prefix (remotes/origin/)
+        const clean = branch.replace(/^remotes\/[^/]+\//, "").trim();
+        if (!clean || clean === "HEAD")
+            continue;
+        const slashIdx = clean.indexOf("/");
+        if (slashIdx > 0) {
+            const prefix = clean.substring(0, slashIdx);
+            prefixCounts.set(prefix + "/*", (prefixCounts.get(prefix + "/*") ?? 0) + 1);
+        }
+    }
+    // Return patterns with at least 1 occurrence, sorted by frequency
+    return Array.from(prefixCounts.entries())
+        .filter(([, count]) => count >= 1)
+        .sort((a, b) => b[1] - a[1])
+        .map(([pattern]) => pattern);
+}
+// ── Main scanner ──────────────────────────────────────────────────
+export async function scanGitConventions(projectRoot) {
+    // Check for .git directory
+    const gitDir = join(projectRoot, ".git");
+    if (!(await fileExists(gitDir))) {
+        return null;
+    }
+    // Fetch git log
+    let recentMessages;
+    try {
+        const { stdout } = await execa("git", ["log", "--oneline", "-50"], { cwd: projectRoot });
+        recentMessages = stdout
+            .split("\n")
+            .map((line) => {
+            // Remove the short hash prefix (first 7-8 chars)
+            const spaceIdx = line.indexOf(" ");
+            return spaceIdx > 0 ? line.substring(spaceIdx + 1).trim() : line.trim();
+        })
+            .filter((msg) => msg.length > 0);
+    }
+    catch {
+        // Git command failed (no commits, etc.)
+        return null;
+    }
+    // Fetch branches
+    let branches = [];
+    try {
+        const { stdout } = await execa("git", ["branch", "-a"], { cwd: projectRoot });
+        branches = stdout
+            .split("\n")
+            .map((b) => b.replace(/^\*?\s+/, "").trim())
+            .filter((b) => b.length > 0);
+    }
+    catch {
+        // Non-fatal
+    }
+    // Analyze commit messages
+    const mergeCommits = recentMessages.filter((m) => MERGE_COMMIT_RE.test(m));
+    const nonMergeMessages = recentMessages.filter((m) => !MERGE_COMMIT_RE.test(m));
+    const conventionalCount = nonMergeMessages.filter((m) => CONVENTIONAL_COMMIT_RE.test(m)).length;
+    const usesConventionalCommits = nonMergeMessages.length > 0 &&
+        conventionalCount / nonMergeMessages.length >= 0.5;
+    const mergeCommitRatio = recentMessages.length > 0
+        ? mergeCommits.length / recentMessages.length
+        : 0;
+    return {
+        usesConventionalCommits,
+        mostCommonPrefix: detectMostCommonPrefix(nonMergeMessages),
+        recentMessages,
+        branchPatterns: detectBranchPatterns(branches),
+        branches,
+        hasLinearHistory: mergeCommitRatio < 0.05,
+        mergeCommitRatio,
+    };
+}
+//# sourceMappingURL=git-conventions.js.map

package/dist/discovery/scanners/git-conventions.js.map

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

package/dist/discovery/scanners/package-scripts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Scanner: Package Scripts
+ *
+ * Reads package.json scripts, maps them to bober command categories,
+ * and detects the package manager from lockfiles.
+ */
+import type { PackageScriptsReport } from "../types.js";
+export declare function scanPackageScripts(projectRoot: string): Promise<PackageScriptsReport | null>;
+//# sourceMappingURL=package-scripts.d.ts.map

package/dist/discovery/scanners/package-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-scripts.d.ts","sourceRoot":"","sources":["../../../src/discovery/scanners/package-scripts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,aAAa,CAAC;AAqGrB,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA8BtC"}

package/dist/discovery/scanners/package-scripts.js

@@ -0,0 +1,112 @@
+/**
+ * Scanner: Package Scripts
+ *
+ * Reads package.json scripts, maps them to bober command categories,
+ * and detects the package manager from lockfiles.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileExists } from "../../utils/fs.js";
+async function detectPackageManager(projectRoot) {
+    if (await fileExists(join(projectRoot, "bun.lockb")))
+        return "bun";
+    if (await fileExists(join(projectRoot, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (await fileExists(join(projectRoot, "yarn.lock")))
+        return "yarn";
+    if (await fileExists(join(projectRoot, "package-lock.json")))
+        return "npm";
+    // Fallback: if package.json exists, assume npm
+    if (await fileExists(join(projectRoot, "package.json")))
+        return "npm";
+    return null;
+}
+function buildRunCommand(pm, scriptName) {
+    switch (pm) {
+        case "yarn":
+            return `yarn ${scriptName}`;
+        case "pnpm":
+            return `pnpm run ${scriptName}`;
+        case "bun":
+            return `bun run ${scriptName}`;
+        case "npm":
+        default:
+            return `npm run ${scriptName}`;
+    }
+}
+// ── Category matching ─────────────────────────────────────────────
+/**
+ * Keywords used to identify bober command categories.
+ * Checked against the script name (key in package.json "scripts").
+ */
+const CATEGORY_PATTERNS = [
+    {
+        category: "build",
+        patterns: [/^build$/, /^compile$/, /^tsc$/, /^bundle$/],
+    },
+    {
+        category: "test",
+        patterns: [/^test$/, /^test:run$/, /^vitest$/, /^jest$/, /^mocha$/],
+    },
+    {
+        category: "lint",
+        patterns: [/^lint$/, /^lint:fix$/, /^eslint$/, /^tslint$/],
+    },
+    {
+        category: "typecheck",
+        patterns: [/^typecheck$/, /^type-check$/, /^types$/, /^tsc:check$/],
+    },
+    {
+        category: "dev",
+        patterns: [/^dev$/, /^start$/, /^serve$/, /^watch$/],
+    },
+    {
+        category: "install",
+        patterns: [/^prepare$/, /^postinstall$/, /^setup$/],
+    },
+];
+function categorizeScript(scriptName, command, pm) {
+    const normalizedName = scriptName.toLowerCase();
+    for (const { category, patterns } of CATEGORY_PATTERNS) {
+        if (patterns.some((p) => p.test(normalizedName))) {
+            return {
+                category,
+                mapping: {
+                    scriptName,
+                    command,
+                    runCommand: buildRunCommand(pm, scriptName),
+                },
+            };
+        }
+    }
+    return null;
+}
+export async function scanPackageScripts(projectRoot) {
+    const pkgPath = join(projectRoot, "package.json");
+    if (!(await fileExists(pkgPath))) {
+        return null;
+    }
+    let pkg;
+    try {
+        const raw = await readFile(pkgPath, "utf-8");
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    const pm = await detectPackageManager(projectRoot);
+    const allScripts = pkg.scripts ?? {};
+    const categorized = {};
+    for (const [scriptName, command] of Object.entries(allScripts)) {
+        const result = categorizeScript(scriptName, command, pm);
+        if (result && !(result.category in categorized)) {
+            categorized[result.category] = result.mapping;
+        }
+    }
+    return {
+        packageManager: pm,
+        allScripts,
+        categorized,
+    };
+}
+//# sourceMappingURL=package-scripts.js.map

package/dist/discovery/scanners/package-scripts.js.map

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

package/dist/discovery/scanners/test-conventions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Scanner: Test Conventions
+ *
+ * Detects test framework, file naming patterns, directory structure,
+ * mocking library, and coverage configuration.
+ */
+import type { TestConventionsReport } from "../types.js";
+export declare function scanTestConventions(projectRoot: string): Promise<TestConventionsReport | null>;
+//# sourceMappingURL=test-conventions.d.ts.map

package/dist/discovery/scanners/test-conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-conventions.d.ts","sourceRoot":"","sources":["../../../src/discovery/scanners/test-conventions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,aAAa,CAAC;AAoOrB,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA8BvC"}