bussing 0.0.1 → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ari.dc.uba.ar
+
+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,100 @@
+# bussing
+
+
+Reviews the local development environment after a task (or at any time) and detects the repositories left untidy: uncommitted or unpushed changes, versions not bumped or not published, outdated cross dependencies and installations contaminated by `npm link` or `devel-sync`. It also tells in which order to clean them up.
+
+
+[![npm-version](https://img.shields.io/npm/v/bussing.svg)](https://npmjs.org/package/bussing)
+[![downloads](https://img.shields.io/npm/dm/bussing.svg)](https://npmjs.org/package/bussing)
+[![build](https://github.com/ari-dc-uba-ar/bussing/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/ari-dc-uba-ar/bussing/actions/workflows/build-and-test.yml)
+[![qa-control](https://github.com/ari-dc-uba-ar/bussing/actions/workflows/qa-control.yml/badge.svg)](https://github.com/ari-dc-uba-ar/bussing/actions/workflows/qa-control.yml)
+
+
+language: ![English](https://raw.githubusercontent.com/codenautas/multilang/master/img/lang-en.png)
+also available in:
+[![Spanish](https://raw.githubusercontent.com/codenautas/multilang/master/img/lang-es.png)](LEEME.md)
+
+
+## Reviewed repositories
+
+The root folders are set with `--path` (it can be repeated). Every subfolder of a root folder that has a `package.json` is a repository to review, except those named as one of the values of `--ignore` (it can be repeated too).
+
+## Default values
+
+The optional file `~/.bussing.yaml` sets default values for the parameters; the keys are the parameter names (`bussing --help`). What is given in the command line takes precedence. Relative folders are relative to the current folder, as in the command line.
+
+```yaml
+path:
+  - /path/to/repos
+  - /path/to/other-repos
+ignore:
+  - old-repo
+priority:
+  qa-control: 1
+  require-bro: -1
+```
+
+## Checks
+
+### 1. git
+
+* There are uncommitted changes (including untracked files that are not ignored).
+* There are unpushed commits.
+* The current branch has no upstream.
+
+### 2. Publication
+
+The local `package.json` is compared with the npm registry:
+
+* **Unpublished version:** the local version is greater than the last published one.
+* **Version not bumped:** the local version equals the published one, but the local `HEAD` differs from the `gitHead` npm recorded when that version was published (there are commits after the publication).
+* **Not published:** the package does not exist in npm.
+
+Packages with `"private": true` are not checked.
+
+### 3. Cross dependencies
+
+If repository **A** depends on repository **B** (both reviewed) and A's `package.json` declares B with a version lower than B's local version, A has an outdated dependency. `dependencies`, `devDependencies`, `optionalDependencies` and `peerDependencies` are checked; the declared version is the minimum of the range (`^1.2.0` is lower than `1.3.0` even if the range allows it).
+
+If a package name is in more than one reviewed repository, it is reported and that name is not used for cross dependencies nor for the order.
+
+### 4. Contaminated installation
+
+For each dependency in `node_modules`:
+
+* **`npm link`:** `node_modules/<package>` is a symbolic link.
+* **Copy (`devel-sync` or other):** the content of `node_modules/<package>` does not match the published package of the version recorded in `package-lock.json`. Only packages that are reviewed repositories are checked (the only ones copied during development). It takes into account that, when installing, npm changes CRLF to LF in the shebang of the executables declared in `bin`.
+
+### 5. Cleanup order
+
+With the untidy repositories a topological order is built: first the ones that do not depend on any other repository of the list. Those that depend on a repository whose problems reach its users also enter, marked as "by dependency" (with the field suffix): uncommitted or unpushed changes, version not bumped or not published, or outdated production, peer or optional dependencies. Outdated devDependencies and altered node_modules do not reach the package's users. For each repository the reason it is on the list is shown.
+
+`dependencies`, `optionalDependencies` and `peerDependencies` are strong dependencies: they define which repositories enter the list and are always respected in the order. `devDependencies` are weak: they are respected unless they close a cycle, because among one's own packages they form cycles (for example, qa-control is a devDependency of libraries it depends on). Those that would close a cycle are deferred: the step shows it and that dependency stays outdated until a later review. With `--priority package=number` (it can be repeated; 0 by default) you decide which weak dependencies are respected first: higher numbers are respected earlier and lower numbers are the first to be deferred. If there is a cycle of strong dependencies, its members are placed in the same step and the cycle is shown.
+
+Each step shows the most serious problem of the repository. From most to least serious: uncommitted changes, unpushed commits, altered node_modules, then waiting for / outdated `dependencies`, `peerDependencies`, `optionalDependencies` and `devDependencies` (in that order; waiting means some outdated dependency has its own problems and comes earlier in the order), version not bumped, not published. Those that enter only because of their dependencies are marked as such.
+
+## Usage
+
+### Command line
+
+```sh
+bussing --path /path/to/repos --path /path/to/other-repos
+bussing --json
+```
+
+It shows a readable report; with `--json` it shows the full report as JSON. The parameters and the exit codes are described in `bussing --help`.
+
+### As a library
+
+`bussing` can be included from another system. `reviewEnvironment` receives typed options and returns the typed report; it does not write to the output nor end the process.
+
+```ts
+import { reviewEnvironment } from 'bussing';
+
+const report = await reviewEnvironment({ roots: ['/path/to/repos'] });
+```
+
+
+## License
+
+[MIT](LICENSE)

package/dist/bussing-cli.d.ts

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { type GuaranteedType } from 'guarantee-type';
+import type { ProblemCategory, BussingReport, Problem } from './bussing.js';
+export declare const EXIT_CODE: {
+    readonly clean: 0;
+    readonly error: 1;
+    readonly problems: 2;
+};
+/** Cómo se nombra el archivo de valores por omisión en los mensajes y en la ayuda. */
+export declare const DEFAULTS_FILE_LABEL = "~/.bussing.yaml";
+export declare function defaultsPath(): string;
+/** Interpreta `paquete=número` (el número puede ser negativo). */
+export declare function parsePriority(value: string): [string, number];
+declare const defaultsDescription: {
+    object: {
+        path: {
+            optional: {
+                union: ({
+                    array: {
+                        string: import("guarantee-type").Opts;
+                    };
+                } | {
+                    string: import("guarantee-type").Opts;
+                })[];
+            };
+        };
+        ignore: {
+            optional: {
+                union: ({
+                    array: {
+                        string: import("guarantee-type").Opts;
+                    };
+                } | {
+                    string: import("guarantee-type").Opts;
+                })[];
+            };
+        };
+        priority: {
+            optional: {
+                recordString: {
+                    number: import("guarantee-type").Opts;
+                };
+            };
+        };
+        registry: {
+            optional: {
+                string: import("guarantee-type").Opts;
+            };
+        };
+        json: {
+            optional: {
+                boolean: import("guarantee-type").Opts;
+            };
+        };
+    };
+};
+type DefaultsFile = GuaranteedType<typeof defaultsDescription>;
+/** Valores por omisión ya normalizados: `path` e `ignore` siempre son listas. */
+export type Defaults = Omit<DefaultsFile, 'path' | 'ignore'> & {
+    path?: string[];
+    ignore?: string[];
+};
+export interface CliOptions {
+    roots: string[];
+    ignore: string[];
+    priority: Record<string, number>;
+    registry: string;
+    json: boolean;
+}
+/**
+ * Lee el archivo de valores por omisión. Si no existe o está vacío no hay valores por omisión.
+ * `label` es el nombre del archivo en los mensajes de error.
+ */
+export declare function readDefaults(file: string, label: string): Defaults;
+/**
+ * Interpreta los argumentos. cleye muestra la ayuda y termina el proceso ante `--help`, `--version` o un flag desconocido.
+ * La primera línea de la salida es la versión, salvo que la salida sea JSON; `write` indica dónde se escribe (por omisión, la salida estándar).
+ */
+export declare function parseArgs(argv: string[], defaults: Defaults, write?: (text: string) => void): CliOptions;
+export declare function describeProblem(problem: Problem): string;
+export declare const CATEGORY_LABEL: Record<ProblemCategory, string>;
+export declare function formatReport(report: BussingReport): string;
+export declare function main(argv: string[]): Promise<number>;
+export {};

package/dist/bussing-cli.js

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+// Línea de comandos de bussing. Es el único módulo que usa cleye y process.
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import { cli, parseCommandLine, runMain } from 'commendatore';
+import { guarantee, is } from 'guarantee-type';
+import { load } from 'js-yaml';
+import { DEFAULT_REGISTRY_URL, createNpmRegistry, reviewEnvironment } from './bussing.js';
+export const EXIT_CODE = {
+    clean: 0,
+    error: 1,
+    problems: 2,
+};
+const EXIT_CODES = [
+    { code: EXIT_CODE.clean, description: 'sin problemas' },
+    { code: EXIT_CODE.error, description: 'error' },
+    { code: EXIT_CODE.problems, description: 'hay problemas' },
+];
+/** Archivo opcional, en la carpeta del usuario, con valores por omisión para los parámetros. */
+const DEFAULTS_FILE_NAME = '.bussing.yaml';
+/** Cómo se nombra el archivo de valores por omisión en los mensajes y en la ayuda. */
+export const DEFAULTS_FILE_LABEL = `~/${DEFAULTS_FILE_NAME}`;
+export function defaultsPath() {
+    return join(homedir(), DEFAULTS_FILE_NAME);
+}
+/** Interpreta `paquete=número` (el número puede ser negativo). */
+export function parsePriority(value) {
+    const match = /^(.+)=(-?\d+)$/.exec(value);
+    if (match === null || match[1] === undefined || match[2] === undefined) {
+        throw new Error(`--priority ${value} no tiene la forma paquete=número`);
+    }
+    return [match[1], Number(match[2])];
+}
+/** Parámetros de la línea de comandos. Las mismas claves se pueden usar en el archivo de valores por omisión. */
+const flags = {
+    path: {
+        type: [String],
+        alias: 'p',
+        description: 'Carpeta raíz a revisar; se puede repetir (cada subcarpeta con package.json es un repositorio)',
+    },
+    ignore: {
+        type: [String],
+        description: 'Nombre de una subcarpeta que no se revisa; se puede repetir',
+    },
+    priority: {
+        type: [parsePriority],
+        description: 'Prioridad de un paquete como devDependency al romper ciclos del orden de limpieza, como paquete=número ' +
+            '(por omisión 0; las de mayor número se respetan primero); se puede repetir',
+    },
+    registry: {
+        type: String,
+        description: `URL del registro de npm (por omisión ${DEFAULT_REGISTRY_URL})`,
+    },
+    json: {
+        type: Boolean,
+        description: 'Muestra el informe completo en JSON',
+    },
+};
+/** Tipo de cada clave del archivo de valores por omisión: una por parámetro (el compilador verifica que sean las mismas). */
+const defaultsFields = {
+    // una carpeta sola o una lista
+    path: { optional: is.union([is.string, is.array.string]) },
+    ignore: { optional: is.union([is.string, is.array.string]) },
+    // en el archivo es un mapa paquete: número
+    priority: is.optional.recordString.number,
+    registry: is.optional.string,
+    json: is.optional.boolean,
+};
+const defaultsDescription = is.object(defaultsFields);
+/**
+ * Lee el archivo de valores por omisión. Si no existe o está vacío no hay valores por omisión.
+ * `label` es el nombre del archivo en los mensajes de error.
+ */
+export function readDefaults(file, label) {
+    if (!existsSync(file))
+        return {};
+    const text = readFileSync(file, 'utf8');
+    if (text.trim() === '')
+        return {};
+    let content;
+    try {
+        content = load(text);
+    }
+    catch (err) {
+        throw new Error(`${label} no es un YAML válido (${err instanceof Error ? err.message : String(err)})`);
+    }
+    if (content === undefined || content === null)
+        return {};
+    if (typeof content !== 'object' || Array.isArray(content))
+        throw new Error(`${label} no contiene claves y valores`);
+    const unknownKeys = Object.keys(content).filter(function (key) { return !(key in flags); });
+    if (unknownKeys.length > 0) {
+        throw new Error(`${label} tiene claves desconocidas: ${unknownKeys.join(', ')} (las claves válidas son: ${Object.keys(flags).join(', ')})`);
+    }
+    let values;
+    try {
+        values = guarantee(defaultsDescription, content);
+    }
+    catch (err) {
+        throw new Error(`${label} tiene valores de tipo incorrecto (${err instanceof Error ? err.message : String(err)})`);
+    }
+    const { path, ignore, ...others } = values;
+    const defaults = others;
+    if (path !== undefined)
+        defaults.path = typeof path === 'string' ? [path] : path;
+    if (ignore !== undefined)
+        defaults.ignore = typeof ignore === 'string' ? [ignore] : ignore;
+    return defaults;
+}
+/**
+ * Interpreta los argumentos. cleye muestra la ayuda y termina el proceso ante `--help`, `--version` o un flag desconocido.
+ * La primera línea de la salida es la versión, salvo que la salida sea JSON; `write` indica dónde se escribe (por omisión, la salida estándar).
+ */
+export function parseArgs(argv, defaults, write) {
+    const { parsed } = parseCommandLine({
+        moduleUrl: import.meta.url,
+        description: 'Revisa los repositorios locales y muestra los que quedaron desprolijos y el orden en que conviene limpiarlos.\n' +
+            `Los valores por omisión de los parámetros se pueden definir en ${DEFAULTS_FILE_LABEL} (las claves son los nombres de los parámetros).`,
+        examples: ['bussing --path ../repos --path ../otros-repos --ignore repo-viejo', 'bussing --priority qa-control=1 --priority require-bro=-1', 'bussing --json'],
+        exitCodes: EXIT_CODES,
+    }, function (base) {
+        return cli({ ...base, flags }, undefined, argv);
+    }, {
+        show: function (parsedArgs) { return !(parsedArgs.flags.json ?? defaults.json ?? false); },
+        ...(write === undefined ? {} : { write }),
+    });
+    // las carpetas relativas son relativas a la carpeta actual, vengan de la línea de comandos o del archivo
+    const roots = (parsed.flags.path.length > 0 ? parsed.flags.path : defaults.path ?? []).map(function (path) { return resolve(path); });
+    if (roots.length === 0) {
+        throw new Error(`Falta indicar la carpeta con --path o definir los parámetros predeterminados en ${DEFAULTS_FILE_LABEL}`);
+    }
+    return {
+        roots,
+        ignore: parsed.flags.ignore.length > 0 ? parsed.flags.ignore : defaults.ignore ?? [],
+        priority: parsed.flags.priority.length > 0 ? Object.fromEntries(parsed.flags.priority) : defaults.priority ?? {},
+        registry: parsed.flags.registry ?? defaults.registry ?? DEFAULT_REGISTRY_URL,
+        json: parsed.flags.json ?? defaults.json ?? false,
+    };
+}
+const MAX_LISTED = 5;
+function listSome(items) {
+    return items.slice(0, MAX_LISTED).join(', ') + (items.length > MAX_LISTED ? `, … (${items.length - MAX_LISTED} más)` : '');
+}
+function plural(count, singular, pluralForm) {
+    return `${count} ${count === 1 ? singular : pluralForm}`;
+}
+export function describeProblem(problem) {
+    switch (problem.kind) {
+        case 'uncommitted':
+            return `${plural(problem.files.length, 'archivo sin commitear', 'archivos sin commitear')}: ${listSome(problem.files)}`;
+        case 'unpushed':
+            return plural(problem.commits, 'commit sin pushear', 'commits sin pushear');
+        case 'no-upstream':
+            return `la rama ${problem.branch} no tiene upstream`;
+        case 'not-published':
+            return `el paquete no está publicado en npm (versión local ${problem.version})`;
+        case 'unpublished-version':
+            return `versión ${problem.version} sin publicar (en npm: ${problem.latest ?? 'sin latest'})`;
+        case 'version-not-bumped':
+            return `versión ${problem.version} sin subir: ${plural(problem.commitsAfterPublish, 'commit posterior', 'commits posteriores')} a la publicación`;
+        case 'outdated-dependency':
+            return `dependencia desactualizada: ${problem.dependency} "${problem.declared}" (${problem.field}), versión local ${problem.local}`;
+        case 'linked-dependency':
+            return `node_modules/${problem.dependency} es un enlace a ${problem.target}`;
+        case 'copied-dependency':
+            return `node_modules/${problem.dependency} no coincide con la versión publicada ${problem.version}` +
+                (problem.installedVersion !== problem.version ? ` (el package.json instalado dice ${problem.installedVersion ?? '?'})` : '') + ': ' +
+                listSome(problem.differences.map(function (difference) { return `${difference.path} (${difference.kind})`; }));
+    }
+}
+function describeWarning(warning) {
+    return `advertencia (${warning.check}): ${warning.message}`;
+}
+function describeRepo(repo) {
+    const title = repo.name === null ? repo.dir : `${repo.name}${repo.version === null ? '' : '@' + repo.version}  ${repo.dir}`;
+    return [
+        title,
+        ...repo.problems.map(function (problem) { return '  - ' + describeProblem(problem); }),
+        ...repo.warnings.map(function (warning) { return '  ? ' + describeWarning(warning); }),
+    ];
+}
+/** Sufijo de cada campo de dependencias en las etiquetas ("dependencias-dev desactualizadas", "por dependencia-peer"). */
+const FIELD_SUFFIX = {
+    'dependencies': '',
+    'peerDependencies': '-peer',
+    'optionalDependencies': '-opt',
+    'devDependencies': '-dev',
+};
+export const CATEGORY_LABEL = {
+    'uncommitted': 'falta commitear',
+    'unpushed': 'falta pushear',
+    'altered-node-modules': 'node_modules alterado',
+    'waiting-dependencies': `espera dependencias${FIELD_SUFFIX.dependencies}`,
+    'outdated-dependencies': `dependencias${FIELD_SUFFIX.dependencies} desactualizadas`,
+    'waiting-peer-dependencies': `espera dependencias${FIELD_SUFFIX.peerDependencies}`,
+    'outdated-peer-dependencies': `dependencias${FIELD_SUFFIX.peerDependencies} desactualizadas`,
+    'waiting-optional-dependencies': `espera dependencias${FIELD_SUFFIX.optionalDependencies}`,
+    'outdated-optional-dependencies': `dependencias${FIELD_SUFFIX.optionalDependencies} desactualizadas`,
+    'waiting-dev-dependencies': `espera dependencias${FIELD_SUFFIX.devDependencies}`,
+    'outdated-dev-dependencies': `dependencias${FIELD_SUFFIX.devDependencies} desactualizadas`,
+    'version-not-bumped': 'falta subir versión',
+    'unpublished': 'falta publicar',
+};
+function describeStep(step) {
+    const details = [];
+    if (step.dependsOn.length > 0)
+        details.push('depende de ' + step.dependsOn.join(', '));
+    if (step.inCycleWith.length > 0)
+        details.push('ciclo con ' + step.inCycleWith.join(', '));
+    if (step.deferred.length > 0)
+        details.push(`ciclo: ${step.deferred.join(', ')} ${step.deferred.length === 1 ? 'se actualiza' : 'se actualizan'} después`);
+    const folder = basename(step.dir);
+    const label = step.mainProblem !== null ? CATEGORY_LABEL[step.mainProblem]
+        : `por dependencia${step.dependencyField === null ? '' : FIELD_SUFFIX[step.dependencyField]}`;
+    return `  ${step.level + 1}. ${step.name}${folder === step.name ? '' : ` [${folder}]`}  ${label}` + (details.length > 0 ? `  (${details.join('; ')})` : '');
+}
+export function formatReport(report) {
+    const withProblems = report.repos.filter(function (repo) { return repo.problems.length > 0; });
+    const withWarningsOnly = report.repos.filter(function (repo) { return repo.problems.length === 0 && repo.warnings.length > 0; });
+    const lines = [`${plural(withProblems.length, 'repositorio con problemas', 'repositorios con problemas')} de ${report.repos.length} revisados` +
+            (report.ignored.length > 0 ? ` (${plural(report.ignored.length, 'ignorado', 'ignorados')}: ${report.ignored.map(function (dir) { return basename(dir); }).join(', ')})` : '')];
+    for (const repo of [...withProblems, ...withWarningsOnly])
+        lines.push('', ...describeRepo(repo));
+    if (report.cleanupOrder.length > 0) {
+        lines.push('', 'Orden de limpieza (los del mismo número no dependen entre sí):', ...report.cleanupOrder.map(describeStep));
+    }
+    if (report.warnings.length > 0)
+        lines.push('', ...report.warnings.map(describeWarning));
+    return lines.join('\n') + '\n';
+}
+export async function main(argv) {
+    try {
+        const options = parseArgs(argv, readDefaults(defaultsPath(), DEFAULTS_FILE_LABEL));
+        const reviewOptions = {
+            roots: options.roots,
+            ignore: options.ignore,
+            dependencyPriority: options.priority,
+            registry: createNpmRegistry(options.registry),
+            log: function (message) { if (process.stderr.isTTY)
+                process.stderr.write(`\r\u001b[K${message}`); },
+        };
+        const report = await reviewEnvironment(reviewOptions);
+        if (process.stderr.isTTY)
+            process.stderr.write('\r\u001b[K');
+        process.stdout.write(options.json ? JSON.stringify(report, null, 2) + '\n' : formatReport(report));
+        return report.repos.some(function (repo) { return repo.problems.length > 0; }) ? EXIT_CODE.problems : EXIT_CODE.clean;
+    }
+    catch (err) {
+        if (process.stderr.isTTY)
+            process.stderr.write('\r\u001b[K');
+        process.stderr.write(`bussing: ${err instanceof Error ? err.message : String(err)}\n`);
+        return EXIT_CODE.error;
+    }
+}
+// Solo se ejecuta al invocarlo como programa (no al importarlo desde los tests)
+if (import.meta.main) {
+    runMain(function () { return main(process.argv.slice(2)); }, EXIT_CODE.error);
+}
+//# sourceMappingURL=bussing-cli.js.map

package/dist/bussing-cli.js.map

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

package/dist/bussing.d.ts

@@ -0,0 +1,5 @@
+import type { BussingOptions, BussingReport } from './types.js';
+export type * from './types.js';
+export { createNpmRegistry, DEFAULT_REGISTRY_URL } from './registry.js';
+export { DEPENDENCY_CATEGORY, mainCategory, PROBLEM_CATEGORIES, PROBLEM_CATEGORY, problemCategory, REACHES_DEPENDENTS } from './categories.js';
+export declare function reviewEnvironment(options: BussingOptions): Promise<BussingReport>;

package/dist/bussing.js

@@ -0,0 +1,140 @@
+// bussing: revisa el ambiente local de repositorios y arma el orden de limpieza.
+// Es la librería (el core): no lee process.argv, no escribe en la salida y no termina el proceso.
+import { basename } from 'node:path';
+import { fieldGravity, mainCategory, problemCategory, REACHES_DEPENDENTS } from './categories.js';
+import { checkCrossDependencies, checkGit, checkInstallation, checkPublication } from './checks.js';
+import { computeCleanupOrder } from './order.js';
+import { createNpmRegistry } from './registry.js';
+import { declaredDependencies, findRepos, ORDER_DEPENDENCY_FIELDS, readPackageJson, WEAK_ORDER_DEPENDENCY_FIELDS } from './repos.js';
+import { defined, mustGet } from './util.js';
+export { createNpmRegistry, DEFAULT_REGISTRY_URL } from './registry.js';
+export { DEPENDENCY_CATEGORY, mainCategory, PROBLEM_CATEGORIES, PROBLEM_CATEGORY, problemCategory, REACHES_DEPENDENTS } from './categories.js';
+/** Cantidad de repositorios que se revisan en paralelo. */
+const CONCURRENCY = 8;
+async function mapWithConcurrency(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    async function worker() {
+        while (next < items.length) {
+            const i = next++;
+            results[i] = await fn(defined(items[i], 'elemento'));
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+    return results;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Ejecuta un control; si falla, lo informa como advertencia del repositorio en lugar de interrumpir la revisión. */
+async function runCheck(report, check, fn) {
+    try {
+        const result = await fn();
+        report.problems.push(...result.problems);
+        report.warnings.push(...result.warnings);
+    }
+    catch (err) {
+        report.warnings.push({ check, message: `falló el control: ${errorMessage(err)}` });
+    }
+}
+export async function reviewEnvironment(options) {
+    const registry = options.registry ?? createNpmRegistry();
+    const log = options.log ?? function () { };
+    const warnings = [];
+    const ignore = options.ignore ?? [];
+    const { repos: dirs, ignored } = await findRepos(options.roots, ignore);
+    for (const name of ignore) {
+        if (!ignored.some(function (dir) { return basename(dir) === name; })) {
+            warnings.push({ check: 'repo', message: `ninguna carpeta de repositorio se llama ${name} (ignore)` });
+        }
+    }
+    log(`${dirs.length} repositorios encontrados`);
+    // package.json de cada repositorio
+    const repos = await Promise.all(dirs.map(async function (dir) {
+        const report = { dir, name: null, version: null, problems: [], warnings: [] };
+        try {
+            const pkg = await readPackageJson(dir);
+            report.name = pkg.name ?? null;
+            report.version = pkg.version ?? null;
+            return { report, pkg };
+        }
+        catch (err) {
+            report.warnings.push({ check: 'repo', message: `no se pudo leer package.json: ${errorMessage(err)}` });
+            return { report, pkg: null };
+        }
+    }));
+    // Nombres locales: los que corresponden a más de un repositorio no se usan para dependencias cruzadas ni orden
+    const dirsByName = new Map();
+    for (const { report } of repos) {
+        if (report.name !== null)
+            dirsByName.set(report.name, [...(dirsByName.get(report.name) ?? []), report.dir]);
+    }
+    const uniqueDirByName = new Map();
+    const localVersions = new Map();
+    for (const [name, list] of dirsByName) {
+        if (list.length > 1) {
+            warnings.push({ check: 'cross-dependencies', message: `el paquete ${name} está en varios repositorios (${list.join(', ')}); no se usa para dependencias cruzadas ni para el orden` });
+            continue;
+        }
+        const dir = defined(list[0], 'carpeta del repositorio');
+        uniqueDirByName.set(name, dir);
+        const version = repos.find(function (repo) { return repo.report.dir === dir; })?.report.version;
+        if (version !== null && version !== undefined)
+            localVersions.set(name, version);
+    }
+    const localNames = new Set(dirsByName.keys());
+    await mapWithConcurrency(repos, CONCURRENCY, async function ({ report, pkg }) {
+        log(`revisando ${report.dir}`);
+        let gitState = null;
+        await runCheck(report, 'git', async function () {
+            const result = await checkGit(report.dir);
+            gitState = result.state;
+            return result;
+        });
+        if (pkg === null)
+            return;
+        await runCheck(report, 'publication', function () { return checkPublication(report.dir, pkg, gitState, registry); });
+        await runCheck(report, 'cross-dependencies', function () { return checkCrossDependencies(pkg, localVersions); });
+        await runCheck(report, 'installation', function () { return checkInstallation(report.dir, localNames, registry); });
+    });
+    /** Repositorios revisados de los que depende en los campos indicados, con el campo más grave si figura en varios. */
+    function localDependencies(report, pkg, fields) {
+        const result = new Map();
+        for (const dep of pkg === null ? [] : declaredDependencies(pkg, fields)) {
+            const depDir = uniqueDirByName.get(dep.name);
+            if (depDir === undefined || depDir === report.dir)
+                continue;
+            const previous = result.get(depDir);
+            if (previous === undefined || fieldGravity(dep.field) < fieldGravity(previous))
+                result.set(depDir, dep.field);
+        }
+        return [...result].map(function ([dir, field]) { return { dir, field }; });
+    }
+    const noWait = function () { return false; };
+    const priority = new Map(Object.entries(options.dependencyPriority ?? {}));
+    for (const name of priority.keys()) {
+        if (!uniqueDirByName.has(name))
+            warnings.push({ check: 'order', message: `ningún repositorio revisado tiene el paquete ${name} (prioridad de dependencia)` });
+    }
+    const nodes = repos.map(function ({ report, pkg }) {
+        return {
+            dir: report.dir,
+            name: report.name ?? basename(report.dir),
+            mainProblem: mainCategory(report.problems, noWait),
+            reachesDependents: report.problems.some(function (problem) { return REACHES_DEPENDENTS[problemCategory(problem, noWait)]; }),
+            dependsOn: localDependencies(report, pkg, ORDER_DEPENDENCY_FIELDS),
+            weakDependsOn: localDependencies(report, pkg, WEAK_ORDER_DEPENDENCY_FIELDS).map(function (dep) { return dep.dir; }),
+        };
+    });
+    const cleanupOrder = computeCleanupOrder(nodes, priority);
+    // "espera dependencias" solo si alguna dependencia desactualizada tiene problemas que llegan a quien la usa y queda antes en el orden
+    const hasProblems = new Set(nodes.filter(function (node) { return node.reachesDependents; }).map(function (node) { return node.name; }));
+    const reportByDir = new Map(repos.map(function (repo) { return [repo.report.dir, repo.report]; }));
+    for (const step of cleanupOrder) {
+        step.mainProblem = mainCategory(mustGet(reportByDir, step.dir).problems, function (name) {
+            return hasProblems.has(name) && step.dependsOn.includes(name);
+        });
+    }
+    return { repos: repos.map(function (repo) { return repo.report; }), ignored, cleanupOrder, warnings };
+}
+//# sourceMappingURL=bussing.js.map