@camaradesuk/git-worktree-tools 1.5.0 → 1.7.0

package/dist/lib/ai/repo-docs.js

@@ -0,0 +1,274 @@
+/**
+ * Repository Documentation Discovery
+ *
+ * Finds and reads README and other documentation files to provide
+ * context for AI generation.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Documentation file patterns to look for, in priority order
+ */
+const DOC_FILE_PATTERNS = [
+    'README.md',
+    'README',
+    'readme.md',
+    'README.rst',
+    'README.txt',
+    'CONTRIBUTING.md',
+    'ARCHITECTURE.md',
+    'docs/README.md',
+    'doc/README.md',
+];
+/**
+ * Maximum length for README content in prompts
+ */
+const MAX_README_LENGTH = 2000;
+/**
+ * Maximum length for project description
+ */
+const MAX_DESCRIPTION_LENGTH = 500;
+/**
+ * Find and read the README file from a repository
+ */
+function findReadme(repoRoot) {
+    for (const pattern of DOC_FILE_PATTERNS) {
+        const filePath = path.join(repoRoot, pattern);
+        if (fs.existsSync(filePath)) {
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                return { content, source: pattern };
+            }
+            catch {
+                // Continue to next pattern
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extract project info from package.json
+ */
+function extractPackageJsonInfo(repoRoot) {
+    const packagePath = path.join(repoRoot, 'package.json');
+    if (!fs.existsSync(packagePath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(packagePath, 'utf-8');
+        const pkg = JSON.parse(content);
+        const techStack = [];
+        // Add main technology
+        if (pkg.devDependencies?.typescript || pkg.dependencies?.typescript) {
+            techStack.push('TypeScript');
+        }
+        else {
+            techStack.push('JavaScript');
+        }
+        // Check for framework
+        if (pkg.dependencies?.react)
+            techStack.push('React');
+        if (pkg.dependencies?.vue)
+            techStack.push('Vue');
+        if (pkg.dependencies?.angular || pkg.dependencies?.['@angular/core'])
+            techStack.push('Angular');
+        if (pkg.dependencies?.express)
+            techStack.push('Express');
+        if (pkg.dependencies?.next)
+            techStack.push('Next.js');
+        if (pkg.dependencies?.nest || pkg.dependencies?.['@nestjs/core'])
+            techStack.push('NestJS');
+        // Check for testing framework
+        if (pkg.devDependencies?.vitest)
+            techStack.push('Vitest');
+        if (pkg.devDependencies?.jest)
+            techStack.push('Jest');
+        if (pkg.devDependencies?.mocha)
+            techStack.push('Mocha');
+        return {
+            description: pkg.description,
+            techStack,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Extract project info from pyproject.toml
+ */
+function extractPyProjectInfo(repoRoot) {
+    const pyprojectPath = path.join(repoRoot, 'pyproject.toml');
+    if (!fs.existsSync(pyprojectPath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(pyprojectPath, 'utf-8');
+        const techStack = ['Python'];
+        // Simple TOML parsing for description
+        const descMatch = content.match(/description\s*=\s*["']([^"']+)["']/);
+        const description = descMatch ? descMatch[1] : undefined;
+        // Check for common frameworks in dependencies
+        if (content.includes('django'))
+            techStack.push('Django');
+        if (content.includes('flask'))
+            techStack.push('Flask');
+        if (content.includes('fastapi'))
+            techStack.push('FastAPI');
+        if (content.includes('pytest'))
+            techStack.push('pytest');
+        return { description, techStack };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Extract project info from Cargo.toml (Rust)
+ */
+function extractCargoInfo(repoRoot) {
+    const cargoPath = path.join(repoRoot, 'Cargo.toml');
+    if (!fs.existsSync(cargoPath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(cargoPath, 'utf-8');
+        const techStack = ['Rust'];
+        // Simple TOML parsing for description
+        const descMatch = content.match(/description\s*=\s*["']([^"']+)["']/);
+        const description = descMatch ? descMatch[1] : undefined;
+        // Check for common frameworks
+        if (content.includes('tokio'))
+            techStack.push('Tokio');
+        if (content.includes('actix'))
+            techStack.push('Actix');
+        if (content.includes('rocket'))
+            techStack.push('Rocket');
+        return { description, techStack };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Extract project info from go.mod (Go)
+ */
+function extractGoModInfo(repoRoot) {
+    const goModPath = path.join(repoRoot, 'go.mod');
+    if (!fs.existsSync(goModPath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(goModPath, 'utf-8');
+        const techStack = ['Go'];
+        // Check for common frameworks
+        if (content.includes('gin-gonic'))
+            techStack.push('Gin');
+        if (content.includes('gorilla/mux'))
+            techStack.push('Gorilla Mux');
+        if (content.includes('echo'))
+            techStack.push('Echo');
+        return { techStack };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Truncate content intelligently, preferring complete sections
+ */
+function truncateReadme(content, maxLength) {
+    if (content.length <= maxLength) {
+        return content;
+    }
+    // Try to truncate at a section boundary (## heading)
+    const truncated = content.slice(0, maxLength);
+    const lastHeading = truncated.lastIndexOf('\n## ');
+    if (lastHeading > maxLength * 0.5) {
+        // Only truncate at heading if we keep at least half the content
+        return truncated.slice(0, lastHeading).trim() + '\n\n[...truncated]';
+    }
+    // Try to truncate at paragraph boundary
+    const lastParagraph = truncated.lastIndexOf('\n\n');
+    if (lastParagraph > maxLength * 0.7) {
+        return truncated.slice(0, lastParagraph).trim() + '\n\n[...truncated]';
+    }
+    // Fall back to hard truncate at word boundary
+    const lastSpace = truncated.lastIndexOf(' ');
+    if (lastSpace > maxLength * 0.9) {
+        return truncated.slice(0, lastSpace).trim() + '...[truncated]';
+    }
+    return truncated + '...[truncated]';
+}
+/**
+ * Gather repository documentation for AI context
+ *
+ * @param repoRoot - Root directory of the repository
+ * @param options - Options for documentation gathering
+ * @returns Documentation context for AI prompts
+ */
+export function gatherRepoDocumentation(repoRoot, options = {}) {
+    const { maxReadmeLength = MAX_README_LENGTH, includeReadme = true, includeTechStack = true, } = options;
+    const result = {};
+    // Find and read README
+    if (includeReadme) {
+        const readme = findReadme(repoRoot);
+        if (readme) {
+            result.readme = truncateReadme(readme.content, maxReadmeLength);
+            result.readmeSource = readme.source;
+        }
+    }
+    // Extract project info from package files
+    if (includeTechStack) {
+        // Try each package format in order of prevalence
+        const packageInfo = extractPackageJsonInfo(repoRoot);
+        const pyInfo = extractPyProjectInfo(repoRoot);
+        const cargoInfo = extractCargoInfo(repoRoot);
+        const goInfo = extractGoModInfo(repoRoot);
+        // Combine tech stacks (first found wins for description)
+        const allTechStack = new Set();
+        [packageInfo, pyInfo, cargoInfo, goInfo].forEach((info) => {
+            if (info.techStack) {
+                info.techStack.forEach((t) => allTechStack.add(t));
+            }
+        });
+        result.techStack = Array.from(allTechStack);
+        // Use first description found
+        result.projectDescription =
+            packageInfo.description || pyInfo.description || cargoInfo.description;
+        // Truncate description if too long
+        if (result.projectDescription && result.projectDescription.length > MAX_DESCRIPTION_LENGTH) {
+            result.projectDescription =
+                result.projectDescription.slice(0, MAX_DESCRIPTION_LENGTH) + '...';
+        }
+    }
+    return result;
+}
+/**
+ * Format documentation for inclusion in prompts
+ *
+ * @param docs - Repository documentation
+ * @returns Formatted string for prompt inclusion
+ */
+export function formatDocsForPrompt(docs) {
+    const parts = [];
+    if (docs.projectDescription) {
+        parts.push(`Project: ${docs.projectDescription}`);
+    }
+    if (docs.techStack && docs.techStack.length > 0) {
+        parts.push(`Tech: ${docs.techStack.join(', ')}`);
+    }
+    if (docs.readme) {
+        // Include a condensed version of the README
+        parts.push(`README:\n${docs.readme}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Check if repository has meaningful documentation
+ */
+export function hasDocumentation(repoRoot) {
+    const readme = findReadme(repoRoot);
+    return readme !== null && readme.content.length > 50;
+}
+//# sourceMappingURL=repo-docs.js.map

package/dist/lib/ai/repo-docs.js.map

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

package/dist/lib/ai/repo-docs.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for repository documentation discovery
+ */
+export {};
+//# sourceMappingURL=repo-docs.test.d.ts.map

package/dist/lib/ai/repo-docs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-docs.test.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/repo-docs.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/lib/ai/repo-docs.test.js

@@ -0,0 +1,357 @@
+/**
+ * Tests for repository documentation discovery
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { gatherRepoDocumentation, formatDocsForPrompt, hasDocumentation } from './repo-docs.js';
+describe('repo-docs', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'repo-docs-test-'));
+    });
+    afterEach(() => {
+        if (tempDir) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+    describe('gatherRepoDocumentation', () => {
+        describe('README discovery', () => {
+            it('finds README.md', () => {
+                fs.writeFileSync(path.join(tempDir, 'README.md'), '# My Project\n\nThis is a test project.');
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.readme).toContain('# My Project');
+                expect(docs.readme).toContain('This is a test project');
+                expect(docs.readmeSource).toBe('README.md');
+            });
+            it('finds lowercase readme.md', () => {
+                fs.writeFileSync(path.join(tempDir, 'readme.md'), '# Lower Case');
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.readme).toContain('# Lower Case');
+                // On case-insensitive filesystems (macOS, Windows), the pattern 'README.md'
+                // matches 'readme.md', so the source may be reported as either case
+                expect(docs.readmeSource?.toLowerCase()).toBe('readme.md');
+            });
+            it('finds README without extension', () => {
+                fs.writeFileSync(path.join(tempDir, 'README'), 'Plain text readme');
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.readme).toContain('Plain text readme');
+                expect(docs.readmeSource).toBe('README');
+            });
+            it('prefers README.md over README', () => {
+                fs.writeFileSync(path.join(tempDir, 'README.md'), '# Markdown');
+                fs.writeFileSync(path.join(tempDir, 'README'), 'Plain text');
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.readme).toContain('# Markdown');
+                expect(docs.readmeSource).toBe('README.md');
+            });
+            it('finds README in docs/ directory', () => {
+                fs.mkdirSync(path.join(tempDir, 'docs'));
+                fs.writeFileSync(path.join(tempDir, 'docs', 'README.md'), '# Docs Readme');
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.readme).toContain('# Docs Readme');
+                expect(docs.readmeSource).toBe('docs/README.md');
+            });
+            it('returns undefined readme when none exists', () => {
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.readme).toBeUndefined();
+                expect(docs.readmeSource).toBeUndefined();
+            });
+            it('respects includeReadme option', () => {
+                fs.writeFileSync(path.join(tempDir, 'README.md'), '# My Project');
+                const docs = gatherRepoDocumentation(tempDir, { includeReadme: false });
+                expect(docs.readme).toBeUndefined();
+            });
+        });
+        describe('README truncation', () => {
+            it('truncates long README at section boundary', () => {
+                const longReadme = `# Project
+
+## Section 1
+This is the first section with some content.
+
+## Section 2
+This is the second section with more content.
+
+## Section 3
+This is the third section.`;
+                fs.writeFileSync(path.join(tempDir, 'README.md'), longReadme);
+                const docs = gatherRepoDocumentation(tempDir, { maxReadmeLength: 100 });
+                expect(docs.readme).toBeDefined();
+                expect(docs.readme.length).toBeLessThanOrEqual(150); // Allow some buffer
+                expect(docs.readme).toContain('[...truncated]');
+            });
+            it('truncates at paragraph boundary when no section boundary', () => {
+                const longReadme = `# Project
+
+This is a very long paragraph that goes on and on without any section breaks.
+
+This is another paragraph that adds more content to the readme file.
+
+And yet another paragraph with even more content.`;
+                fs.writeFileSync(path.join(tempDir, 'README.md'), longReadme);
+                const docs = gatherRepoDocumentation(tempDir, { maxReadmeLength: 100 });
+                expect(docs.readme).toBeDefined();
+                expect(docs.readme).toContain('[...truncated]');
+            });
+            it('does not truncate short README', () => {
+                const shortReadme = '# Short\n\nBrief description.';
+                fs.writeFileSync(path.join(tempDir, 'README.md'), shortReadme);
+                const docs = gatherRepoDocumentation(tempDir, { maxReadmeLength: 2000 });
+                expect(docs.readme).toBe(shortReadme);
+                expect(docs.readme).not.toContain('truncated');
+            });
+        });
+        describe('package.json extraction', () => {
+            it('extracts description from package.json', () => {
+                const pkg = {
+                    name: 'test-project',
+                    description: 'A test project for unit testing',
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.projectDescription).toBe('A test project for unit testing');
+            });
+            it('detects TypeScript from devDependencies', () => {
+                const pkg = {
+                    name: 'ts-project',
+                    devDependencies: { typescript: '^5.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('TypeScript');
+            });
+            it('detects JavaScript when no TypeScript', () => {
+                const pkg = {
+                    name: 'js-project',
+                    dependencies: { lodash: '^4.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('JavaScript');
+            });
+            it('detects React framework', () => {
+                const pkg = {
+                    name: 'react-app',
+                    dependencies: { react: '^18.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('React');
+            });
+            it('detects Vue framework', () => {
+                const pkg = {
+                    name: 'vue-app',
+                    dependencies: { vue: '^3.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Vue');
+            });
+            it('detects Next.js framework', () => {
+                const pkg = {
+                    name: 'nextjs-app',
+                    dependencies: { next: '^13.0.0', react: '^18.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Next.js');
+                expect(docs.techStack).toContain('React');
+            });
+            it('detects Vitest testing framework', () => {
+                const pkg = {
+                    name: 'test-project',
+                    devDependencies: { vitest: '^1.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Vitest');
+            });
+            it('detects Jest testing framework', () => {
+                const pkg = {
+                    name: 'test-project',
+                    devDependencies: { jest: '^29.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Jest');
+            });
+            it('handles malformed package.json gracefully', () => {
+                fs.writeFileSync(path.join(tempDir, 'package.json'), 'not valid json');
+                const docs = gatherRepoDocumentation(tempDir);
+                // Should not throw, just return empty tech stack
+                expect(docs.techStack).toEqual([]);
+            });
+        });
+        describe('pyproject.toml extraction', () => {
+            it('extracts description from pyproject.toml', () => {
+                const content = `[project]
+name = "my-python-project"
+description = "A Python project for testing"
+`;
+                fs.writeFileSync(path.join(tempDir, 'pyproject.toml'), content);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.projectDescription).toBe('A Python project for testing');
+                expect(docs.techStack).toContain('Python');
+            });
+            it('detects Django framework', () => {
+                const content = `[project]
+dependencies = ["django>=4.0"]
+`;
+                fs.writeFileSync(path.join(tempDir, 'pyproject.toml'), content);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Django');
+            });
+            it('detects FastAPI framework', () => {
+                const content = `[project]
+dependencies = ["fastapi>=0.100.0"]
+`;
+                fs.writeFileSync(path.join(tempDir, 'pyproject.toml'), content);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('FastAPI');
+            });
+        });
+        describe('Cargo.toml extraction', () => {
+            it('extracts description from Cargo.toml', () => {
+                const content = `[package]
+name = "my-rust-project"
+description = "A Rust project for testing"
+`;
+                fs.writeFileSync(path.join(tempDir, 'Cargo.toml'), content);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.projectDescription).toBe('A Rust project for testing');
+                expect(docs.techStack).toContain('Rust');
+            });
+            it('detects Tokio runtime', () => {
+                const content = `[dependencies]
+tokio = { version = "1.0", features = ["full"] }
+`;
+                fs.writeFileSync(path.join(tempDir, 'Cargo.toml'), content);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Tokio');
+            });
+        });
+        describe('go.mod extraction', () => {
+            it('detects Go from go.mod', () => {
+                const content = `module github.com/user/project
+
+go 1.21
+`;
+                fs.writeFileSync(path.join(tempDir, 'go.mod'), content);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Go');
+            });
+            it('detects Gin framework', () => {
+                const content = `module github.com/user/project
+
+require github.com/gin-gonic/gin v1.9.0
+`;
+                fs.writeFileSync(path.join(tempDir, 'go.mod'), content);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('Gin');
+            });
+        });
+        describe('combined sources', () => {
+            it('combines tech stack from multiple sources', () => {
+                // package.json with TypeScript
+                const pkg = {
+                    name: 'full-stack',
+                    devDependencies: { typescript: '^5.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                // pyproject.toml with Python
+                const pyproject = `[project]
+dependencies = ["fastapi"]
+`;
+                fs.writeFileSync(path.join(tempDir, 'pyproject.toml'), pyproject);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.techStack).toContain('TypeScript');
+                expect(docs.techStack).toContain('Python');
+                expect(docs.techStack).toContain('FastAPI');
+            });
+            it('uses first found description', () => {
+                // package.json description
+                const pkg = {
+                    name: 'project',
+                    description: 'From package.json',
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                // pyproject.toml description
+                const pyproject = `[project]
+description = "From pyproject.toml"
+`;
+                fs.writeFileSync(path.join(tempDir, 'pyproject.toml'), pyproject);
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.projectDescription).toBe('From package.json');
+            });
+            it('respects includeTechStack option', () => {
+                const pkg = {
+                    name: 'project',
+                    devDependencies: { typescript: '^5.0.0' },
+                };
+                fs.writeFileSync(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+                const docs = gatherRepoDocumentation(tempDir, { includeTechStack: false });
+                expect(docs.techStack).toBeUndefined();
+                expect(docs.projectDescription).toBeUndefined();
+            });
+        });
+        describe('empty repository', () => {
+            it('returns empty documentation for empty directory', () => {
+                const docs = gatherRepoDocumentation(tempDir);
+                expect(docs.readme).toBeUndefined();
+                expect(docs.projectDescription).toBeUndefined();
+                expect(docs.techStack).toEqual([]);
+            });
+        });
+    });
+    describe('formatDocsForPrompt', () => {
+        it('formats documentation with all fields', () => {
+            const docs = {
+                readme: '# Test\n\nThis is a test.',
+                projectDescription: 'A test project',
+                techStack: ['TypeScript', 'React'],
+            };
+            const formatted = formatDocsForPrompt(docs);
+            expect(formatted).toContain('Project: A test project');
+            expect(formatted).toContain('Tech: TypeScript, React');
+            expect(formatted).toContain('README:');
+            expect(formatted).toContain('# Test');
+        });
+        it('formats documentation with only project description', () => {
+            const docs = {
+                projectDescription: 'Just a description',
+            };
+            const formatted = formatDocsForPrompt(docs);
+            expect(formatted).toContain('Project: Just a description');
+            expect(formatted).not.toContain('Tech:');
+            expect(formatted).not.toContain('README:');
+        });
+        it('returns empty string for empty docs', () => {
+            const docs = {};
+            const formatted = formatDocsForPrompt(docs);
+            expect(formatted).toBe('');
+        });
+        it('handles docs with only tech stack', () => {
+            const docs = {
+                techStack: ['Go', 'Gin'],
+            };
+            const formatted = formatDocsForPrompt(docs);
+            expect(formatted).toContain('Tech: Go, Gin');
+        });
+    });
+    describe('hasDocumentation', () => {
+        it('returns true when README exists with content', () => {
+            fs.writeFileSync(path.join(tempDir, 'README.md'), '# Project\n\nThis is a substantial readme with more than 50 characters of content.');
+            expect(hasDocumentation(tempDir)).toBe(true);
+        });
+        it('returns false when no README exists', () => {
+            expect(hasDocumentation(tempDir)).toBe(false);
+        });
+        it('returns false when README is too short', () => {
+            fs.writeFileSync(path.join(tempDir, 'README.md'), '# Hi');
+            expect(hasDocumentation(tempDir)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=repo-docs.test.js.map