@sebasgc0399/agents-md 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sebasgc0399
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# agents-md
+
+CLI para generar archivos `AGENTS.md` automaticamente para proyectos Node.js.
+
+## Tabla de contenido
+
+- [¿Que es AGENTS.md?](#que-es-agentsmd)
+- [Quickstart](#quickstart)
+- [Instalacion](#instalacion)
+- [Uso](#uso)
+- [Perfiles de salida](#perfiles-de-salida)
+- [Proyectos soportados](#proyectos-soportados)
+- [Releases y novedades](#releases-y-novedades)
+- [Desarrollo](#desarrollo)
+- [Contribuciones](#contribuciones)
+- [Soporte](#soporte)
+- [Licencia](#licencia)
+
+## ¿Que es AGENTS.md?
+
+`AGENTS.md` es un "README para AI agents" que reduce alucinaciones al proporcionar:
+
+- Comandos canonicos (setup, test, build, lint)
+- Convenciones de codigo y estilo
+- Guias de testing
+- Reglas de seguridad
+- Definition of Done
+
+## Quickstart
+
+Nombres importantes para evitar confusion:
+
+- Package en npm: `@sebasgc0399/agents-md`
+- Comando instalado: `agents-md`
+- No usar `npx agents-md ...` sin scope
+
+Uso sin instalacion (recomendado):
+
+```bash
+npx -p @sebasgc0399/agents-md agents-md init
+npx -p @sebasgc0399/agents-md agents-md init --dry-run
+npx -p @sebasgc0399/agents-md agents-md init --profile compact
+npx -p @sebasgc0399/agents-md agents-md init --profile standard
+npx -p @sebasgc0399/agents-md agents-md init --profile full
+```
+
+## Instalacion
+
+Opcion 1: sin instalacion (npx)
+
+```bash
+npx -p @sebasgc0399/agents-md agents-md init
+```
+
+Opcion 2: instalacion global
+
+```bash
+npm install -g @sebasgc0399/agents-md
+agents-md init
+```
+
+Requisitos:
+
+- Node.js >= 18
+- `package.json` en la raiz del proyecto
+
+## Uso
+
+```bash
+# Generar AGENTS.md en el directorio actual
+agents-md init
+
+# Preview sin escribir archivo
+agents-md init --dry-run
+
+# Elegir perfil de salida (default: compact)
+agents-md init --profile compact
+agents-md init --profile standard
+agents-md init --profile full
+
+# Sobrescribir archivo existente
+agents-md init --force
+
+# Modo verbose (mostrar detalles de deteccion)
+agents-md init --verbose
+
+# Especificar ruta de salida
+agents-md init --out ./docs/AGENTS.md
+```
+
+Nota: en la version `v0.2.x`, las flags `-y/--yes` y `-i/--interactive` estan reservadas y actualmente no cambian el comportamiento del comando.
+
+## Perfiles de salida
+
+- `compact` (default): salida corta y directa (hasta ~110 lineas)
+- `standard`: salida mas completa para equipos (~150-230 lineas)
+- `full`: salida mas detallada para handoff y CI (~220-360 lineas)
+
+## Limites de salida (soft limits)
+
+- `compact`: 50-110 lines, max ~900 tokens
+- `standard`: 150-230 lines, max ~1600 tokens
+- `full`: 220-360 lines, max ~2400 tokens
+
+Exceder estos rangos genera warnings y no bloquea la generacion. La generacion solo se bloquea cuando hay errors de validacion.
+
+## Proyectos soportados
+
+- React (Vite, CRA, Next.js)
+- Vue (Vite, Nuxt)
+- Firebase Functions
+- Proyectos Node.js genericos
+- Monorepos (Turborepo/Nx)
+
+## Como funciona
+
+1. Lee `package.json`.
+2. Detecta framework y estructura de carpetas.
+3. Extrae comandos canonicos desde scripts.
+4. Genera un `AGENTS.md` limpio y conciso segun el perfil seleccionado.
+
+## Releases y novedades
+
+Version actual: `v0.2.0`
+
+Cambios en esta version:
+
+- Benchmark de calidad P0/P1/P2 integrado (`benchmark:lite`, `benchmark:p1`, `benchmark:p2`)
+- Gates de calidad en CI para benchmark lite + baseline semantico P1
+- Workflow semanal/manual de tendencias (`benchmark-trends`) con reporte JSON/Markdown
+
+Actualizar a la ultima version global:
+
+```bash
+npm update -g @sebasgc0399/agents-md
+```
+
+[Ver historial completo de versiones](https://github.com/sebasgc0399/agents-md/releases)
+
+## Desarrollo
+
+```bash
+# Instalar dependencias
+npm install
+
+# Build
+npm run build
+
+# Modo desarrollo (watch)
+npm run dev
+
+# Tests
+npm test
+
+# Coverage
+npm run test:coverage
+
+# Lint (verificar tipos)
+npm run lint
+
+# Benchmark lite (P0 quality gate)
+npm run benchmark:lite
+
+# Benchmark P1 (semantic baseline + regression budget)
+npm run benchmark:p1
+
+# Regenerar baseline P1 (solo cuando el cambio es intencional)
+npm run benchmark:p1:update
+
+# Benchmark P2 (weekly trends report, non-blocking)
+npm run benchmark:p2
+
+# Smoke del CLI compilado
+node dist/cli.js init --dry-run
+```
+
+## Contribuciones
+
+Gracias por ayudar a mejorar `agents-md`.
+
+Para mantener el proyecto de alta calidad:
+
+- Abre un issue primero para cambios no triviales.
+- Incluye problema, solucion propuesta y trade-off tecnico.
+- Si usaste IA, revisa manualmente el resultado antes de abrir PR.
+- Manten los PRs pequenos y enfocados.
+- Agrega o actualiza tests cuando cambie el comportamiento.
+- Ejecuta `npm test` antes de enviar.
+
+Comandos de desarrollo y validacion: ver seccion `## Desarrollo`.
+
+## Soporte
+
+Si esta herramienta te resulta util, puedes apoyar el proyecto de estas formas:
+
+- Dar estrella al repo
+- Compartirlo con tu equipo
+- Reportar bugs con pasos reproducibles
+- Proponer mejoras via issues o PRs acotados
+
+## Licencia
+
+MIT © 2026 sebasgc0399

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for agents-md
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for agents-md
+ */
+import { Command } from 'commander';
+import fs from 'fs';
+import path from 'path';
+import { detectProject } from './detect/index.js';
+import { renderAgentsMd } from './render/index.js';
+import { Logger } from './utils/logger.js';
+import { directoryExists, isPathSafe } from './utils/fs-utils.js';
+const program = new Command();
+const VALID_PROFILES = ['compact', 'standard', 'full'];
+program
+    .name('agents-md')
+    .description('Generate AGENTS.md files for AI coding agents')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Generate AGENTS.md file')
+    .argument('[path]', 'Project directory', process.cwd())
+    .option('--out <path>', 'Output file path', './AGENTS.md')
+    .option('--force', 'Overwrite existing file', false)
+    .option('--dry-run', 'Preview without writing', false)
+    .option('-y, --yes', 'Skip confirmations', false)
+    .option('-i, --interactive', 'Interactive mode', false)
+    .option('--profile <profile>', 'Output profile: compact|standard|full', 'compact')
+    .option('--verbose', 'Verbose output', false)
+    .action(async (projectPath, options) => {
+    const logger = new Logger(options.verbose);
+    try {
+        const profile = String(options.profile || 'compact');
+        if (!VALID_PROFILES.includes(profile)) {
+            logger.error(`Invalid profile "${profile}". Valid values: ${VALID_PROFILES.join(', ')}`);
+            process.exit(1);
+        }
+        // Validate project path
+        if (!directoryExists(projectPath)) {
+            logger.error(`Directory not found: ${projectPath}`);
+            process.exit(1);
+        }
+        // Resolve output path
+        const outputPath = path.resolve(projectPath, options.out);
+        // Validate output path is safe (prevent path traversal)
+        if (!isPathSafe(projectPath, outputPath)) {
+            logger.error('Output path must be within the project directory');
+            process.exit(1);
+        }
+        // Check if output file exists
+        if (fs.existsSync(outputPath) && !options.force && !options.dryRun) {
+            logger.error(`${options.out} already exists. Use --force to overwrite.`);
+            process.exit(1);
+        }
+        // Run detection
+        logger.verbose('Reading package.json...');
+        const detection = await detectProject(projectPath);
+        logger.verbose(`Found: ${detection.packageInfo?.name} v${detection.packageInfo?.version || '?'}`);
+        logger.verbose('Detecting framework...');
+        logger.verbose(`Framework: ${detection.framework.type} (confidence: ${detection.framework.confidence})`);
+        if (options.verbose && detection.framework.indicators.length > 0) {
+            detection.framework.indicators.forEach(indicator => {
+                logger.verbose(`  - ${indicator}`);
+            });
+        }
+        logger.verbose('Extracting commands...');
+        if (options.verbose) {
+            logger.verbose(`  - install: ${detection.commands.install}`);
+            if (detection.commands.dev)
+                logger.verbose(`  - dev: ${detection.commands.dev}`);
+            if (detection.commands.build)
+                logger.verbose(`  - build: ${detection.commands.build}`);
+            if (detection.commands.test)
+                logger.verbose(`  - test: ${detection.commands.test}`);
+            if (detection.commands.lint)
+                logger.verbose(`  - lint: ${detection.commands.lint}`);
+        }
+        // Render AGENTS.md
+        logger.verbose('Rendering template...');
+        logger.verbose(`Profile: ${profile}`);
+        const result = renderAgentsMd(detection, profile);
+        logger.verbose('Validating output...');
+        logger.verbose(`  - Lines: ${result.validation.lineCount}`);
+        logger.verbose(`  - Tokens: ~${result.validation.estimatedTokens}`);
+        // Show validation warnings
+        if (result.validation.warnings.length > 0) {
+            result.validation.warnings.forEach(warning => {
+                logger.warning(warning);
+            });
+        }
+        // Show validation errors (should stop generation)
+        if (result.validation.errors.length > 0) {
+            result.validation.errors.forEach(error => {
+                logger.error(error);
+            });
+            logger.error('Generation failed due to validation errors');
+            process.exit(1);
+        }
+        // Dry run or write
+        if (options.dryRun) {
+            logger.info('--- Preview (--dry-run mode) ---');
+            console.log(result.content);
+            logger.info('--- End of preview ---');
+        }
+        else {
+            if (fs.existsSync(outputPath) && options.force) {
+                logger.warning(`${options.out} already exists. Overwriting...`);
+            }
+            fs.writeFileSync(outputPath, result.content, 'utf-8');
+            logger.success(`Generated ${options.out}`);
+            if (!options.verbose) {
+                logger.info(`Detected: ${detection.framework.type !== 'unknown' ? detection.framework.type : 'Node.js project'}`);
+                logger.info(`${result.validation.lineCount} lines, ~${result.validation.estimatedTokens} tokens`);
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            logger.error(error.message);
+        }
+        else {
+            logger.error('An unknown error occurred');
+        }
+        process.exit(1);
+    }
+});
+// Parse CLI arguments
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/detect/command-detector.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Canonical command extraction from package.json scripts
+ */
+import { CanonicalCommands, PackageInfo, RuntimeInfo } from '../types.js';
+export declare function detectCommands(packageInfo: PackageInfo, runtime: RuntimeInfo): CanonicalCommands;
+//# sourceMappingURL=command-detector.d.ts.map

package/dist/detect/command-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-detector.d.ts","sourceRoot":"","sources":["../../src/detect/command-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1E,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,WAAW,GACnB,iBAAiB,CA8BnB"}

package/dist/detect/command-detector.js

@@ -0,0 +1,62 @@
+/**
+ * Canonical command extraction from package.json scripts
+ */
+export function detectCommands(packageInfo, runtime) {
+    const scripts = packageInfo.scripts || {};
+    const pm = runtime.packageManager;
+    // Install command (inferred from package manager)
+    const install = pm === 'npm' ? 'npm install' : pm === 'yarn' ? 'yarn' : `${pm} install`;
+    // Dev command (priority: dev > start > serve)
+    const dev = findScript(scripts, ['dev', 'start', 'serve'], pm);
+    // Build command (priority: build > compile)
+    const build = findScript(scripts, ['build', 'compile'], pm);
+    // Test command (priority: test > test:unit > vitest > jest)
+    const test = findScript(scripts, ['test', 'test:unit', 'vitest', 'jest'], pm);
+    // Lint command (priority: lint > eslint)
+    const lint = findScript(scripts, ['lint', 'eslint'], pm);
+    // Format command (priority: format > prettier)
+    const format = findScript(scripts, ['format', 'prettier'], pm);
+    return {
+        install,
+        dev,
+        build,
+        test,
+        lint,
+        format,
+    };
+}
+/**
+ * Find first matching script from priority list
+ */
+function findScript(scripts, priorities, packageManager) {
+    for (const scriptName of priorities) {
+        if (scripts[scriptName]) {
+            return buildCommand(scriptName, packageManager);
+        }
+    }
+    return null;
+}
+/**
+ * Build command string with package manager
+ */
+function buildCommand(scriptName, packageManager) {
+    // Special case: "start" and "test" don't need "run" in npm
+    if ((scriptName === 'start' || scriptName === 'test') && packageManager === 'npm') {
+        return `npm ${scriptName}`;
+    }
+    // Yarn also doesn't need "run" for built-in scripts
+    if ((scriptName === 'start' || scriptName === 'test') && packageManager === 'yarn') {
+        return `yarn ${scriptName}`;
+    }
+    // All other cases
+    if (packageManager === 'npm') {
+        return `npm run ${scriptName}`;
+    }
+    else if (packageManager === 'yarn') {
+        return `yarn ${scriptName}`;
+    }
+    else {
+        return `${packageManager} run ${scriptName}`;
+    }
+}
+//# sourceMappingURL=command-detector.js.map

package/dist/detect/command-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-detector.js","sourceRoot":"","sources":["../../src/detect/command-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,cAAc,CAC5B,WAAwB,EACxB,OAAoB;IAEpB,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;IAC1C,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAElC,kDAAkD;IAClD,MAAM,OAAO,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC;IAExF,8CAA8C;IAC9C,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/D,4CAA4C;IAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IAE5D,4DAA4D;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAE9E,yCAAyC;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,+CAA+C;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/D,OAAO;QACL,OAAO;QACP,GAAG;QACH,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CACjB,OAA+B,EAC/B,UAAoB,EACpB,cAAsB;IAEtB,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACxB,OAAO,YAAY,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,UAAkB,EAAE,cAAsB;IAC9D,2DAA2D;IAC3D,IAAI,CAAC,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,MAAM,CAAC,IAAI,cAAc,KAAK,KAAK,EAAE,CAAC;QAClF,OAAO,OAAO,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,MAAM,CAAC,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;QACnF,OAAO,QAAQ,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,kBAAkB;IAClB,IAAI,cAAc,KAAK,KAAK,EAAE,CAAC;QAC7B,OAAO,WAAW,UAAU,EAAE,CAAC;IACjC,CAAC;SAAM,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,QAAQ,UAAU,EAAE,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,cAAc,QAAQ,UAAU,EAAE,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/detect/folder-detector.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Folder structure detection
+ */
+import { FolderStructure, PackageInfo } from '../types.js';
+export declare function detectFolderStructure(rootPath: string, packageInfo?: PackageInfo | null): FolderStructure;
+//# sourceMappingURL=folder-detector.d.ts.map

package/dist/detect/folder-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-detector.d.ts","sourceRoot":"","sources":["../../src/detect/folder-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG3D,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,GAC/B,eAAe,CAsDjB"}

package/dist/detect/folder-detector.js

@@ -0,0 +1,69 @@
+/**
+ * Folder structure detection
+ */
+import path from 'path';
+import { directoryExists, fileExists } from '../utils/fs-utils.js';
+export function detectFolderStructure(rootPath, packageInfo) {
+    const checkDir = (dir) => directoryExists(path.join(rootPath, dir));
+    const checkFile = (fileName) => fileExists(path.join(rootPath, fileName));
+    const hasSrc = checkDir('src');
+    const hasFunctions = checkDir('functions');
+    const hasApps = checkDir('apps');
+    const hasPackages = checkDir('packages');
+    const hasPublic = checkDir('public');
+    const hasDocs = checkDir('docs');
+    // Check for test directories (multiple common names)
+    const hasTests = checkDir('tests') || checkDir('test') || checkDir('__tests__');
+    const hasWorkspaces = hasWorkspaceDefinition(packageInfo?.workspaces);
+    const hasMonorepoTool = Boolean(packageInfo?.devDependencies?.turbo) ||
+        Boolean(packageInfo?.devDependencies?.nx);
+    const hasMonorepoToolWithFolderHints = hasMonorepoTool && (hasApps || hasPackages);
+    const hasMonorepoMarkers = checkFile('pnpm-workspace.yaml') ||
+        checkFile('turbo.json') ||
+        checkFile('nx.json') ||
+        checkFile('lerna.json');
+    // Monorepo signals: folder structure, workspaces, tools, or marker files.
+    const isMonorepo = (hasApps && hasPackages) ||
+        hasWorkspaces ||
+        hasMonorepoToolWithFolderHints ||
+        hasMonorepoMarkers;
+    const folders = [];
+    if (hasSrc)
+        folders.push('src');
+    if (hasFunctions)
+        folders.push('functions');
+    if (hasTests)
+        folders.push('tests');
+    if (hasApps)
+        folders.push('apps');
+    if (hasPackages)
+        folders.push('packages');
+    if (hasPublic)
+        folders.push('public');
+    if (hasDocs)
+        folders.push('docs');
+    return {
+        hasSrc,
+        hasFunctions,
+        hasTests,
+        hasApps,
+        hasPackages,
+        hasPublic,
+        hasDocs,
+        isMonorepo,
+        folders,
+    };
+}
+function hasWorkspaceDefinition(workspaces) {
+    if (!workspaces) {
+        return false;
+    }
+    if (Array.isArray(workspaces)) {
+        return workspaces.length > 0;
+    }
+    if (Array.isArray(workspaces.packages)) {
+        return workspaces.packages.length > 0;
+    }
+    return false;
+}
+//# sourceMappingURL=folder-detector.js.map

package/dist/detect/folder-detector.js.map

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

package/dist/detect/framework-detector.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Framework detection based on dependencies
+ */
+import { FrameworkInfo, PackageInfo } from '../types.js';
+export declare function detectFramework(packageInfo: PackageInfo): FrameworkInfo;
+/**
+ * Detect build tools
+ */
+export declare function detectBuildTools(packageInfo: PackageInfo): string[];
+//# sourceMappingURL=framework-detector.d.ts.map

package/dist/detect/framework-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-detector.d.ts","sourceRoot":"","sources":["../../src/detect/framework-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAExE,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa,CA2GvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CAanE"}