@alint-js/cli 0.0.19 → 0.0.21

package/README.md

@@ -24,12 +24,14 @@ While `alint` is inspired by `eslint`, we expect the concept that `alint` brings
 
 ### Prerequisites
 
-`alint` is published as ESM packages and is intended for modern Node.js projects. Install Node.js and a package manager such as npm or pnpm before using the CLI.
+`alint` is written in TypeScript and published as ESM packages for JavaScript and TypeScript projects. Release builds also include standalone binaries, so teams working in Python, Go, Rust, and other non-Node.js projects can run the CLI without setting up Node.js, npm, or pnpm.
 
 You also need at least one OpenAI-compatible model provider. Local providers such as Ollama and LM Studio work well for repeated lint runs because they keep token cost predictable.
 
 ### Install the CLI
 
+Download a standalone binary from the GitHub release assets when you want to use `alint` without a Node.js toolchain.
+
 Install globally if you want an `alint` command available everywhere:
 
 ```bash
@@ -40,12 +42,12 @@ pnpm add -g @alint-js/cli
 Or install it in a project and run it through your package manager:
 
 ```bash
-npm install -D @alint-js/cli @alint-js/core
+npm install -D @alint-js/cli
 npx alint src
 ```
 
 ```bash
-pnpm add -D @alint-js/cli @alint-js/core
+pnpm add -D @alint-js/cli
 pnpm exec alint src
 ```
 
@@ -171,12 +173,12 @@ In order to provision models and LLMs for `alint` while keeping it clean for con
 The priorities follow:
 
 ```text
-~/.config/alint/config.toml < .alint/config.toml < alint.config.ts < environment and CLI overrides
+~/.config/alint/config.toml < .alint/config.toml < alint.config.* < environment and CLI overrides
 ```
 
 - `~/.config/alint/config.toml` stores user-level provider setup.
 - `.alint/config.toml` stores optional project-local provider setup.
-- `alint.config.ts` stores project lint config, plugins, files, ignores, and rule settings.
+- `alint.config.*` stores project lint config, plugins, files, ignores, and rule settings.
 - Environment variables and CLI flags are the highest-priority overrides.
 
 Use setup TOML for machine or project provider definitions:
@@ -216,7 +218,7 @@ alint setup -N \
 Similar to `eslint`, use `alint.config.ts` for files, ignores, plugins, and rules:
 
 ```ts
-import { defineConfig } from '@alint-js/core'
+import { defineConfig } from '@alint-js/cli'
 import { examplePlugin } from '@alint-js/plugin-example'
 
 export default defineConfig([
@@ -240,6 +242,46 @@ export default defineConfig([
 ])
 ```
 
+#### Executable and static configs
+
+`alint` supports executable configs (`.js`, `.ts`, `.mjs`, `.cjs`, `.mts`, and `.cts`) and data-only static configs (`.toml`, `.yaml`, `.yml`, `.json`, `.jsonc`, and `.json5`).
+
+- Executable configs export a flat config array and can import plugin definitions directly.
+- Static configs use a `config.group` array and identify plugin sources with strings. They are useful for Python, Rust, Go, and other repositories that do not want to author a JavaScript config file or install a Node.js package manager just to run `alint`.
+
+For example, a TOML static config can install an exact remote package or a local plugin directory:
+
+```toml
+[[config.group]]
+
+[config.group.plugins]
+plugin_1 = "@scope/alint-plugin-example1@1.2.3" # package
+plugin_2 = "./plugins/relative-plugin-examplex" # relative directory
+plugin_3 = "/opt/alint/plugins/absolute-plugin" # absolute directory
+```
+
+Relative plugin paths are resolved from the directory containing the config file, including when `--config` points to a nested config. On Windows, use TOML literal strings to preserve native backslashes:
+
+```toml
+[[config.group]]
+
+[config.group.plugins]
+native = 'C:\alint\plugins\native-plugin'
+```
+
+Use `alint plugin install` after adding or changing plugin sources.
+
+- **Package:** `@scope/alint-plugin-example1@1.2.3` downloads that exact version into `.alint/plugins/store`, verifies its integrity, and loads its root export.
+- **Local:** `./plugins/my-plugin` or an absolute directory loads the current package root export in place. `alint` checks that the package and entry exist and that the entry stays inside the package directory. It does not build the plugin or install the plugin's dependencies.
+
+Run the install command again after changing a source string, moving a local directory, or changing its symlink target. Changes inside the same local directory are loaded by the next CLI process without reinstalling.
+
+Local plugins execute as trusted Node.js code. Directory containment checks validate the installed source; they are not a sandbox.
+
+#### Plugin lockfile
+
+`alint plugin install` writes `.alint/plugins/lock.json`. Package entries lock the downloaded package and integrity metadata. Local entries lock the physical directory identity while loading its current contents at runtime.
+
 Rule severities follow the familiar lint convention:
 
 - `"off"` or `0` disables a rule.
@@ -251,7 +293,7 @@ Flat configs can analyze non-JavaScript files by selecting `text/plain`:
 ```ts
 import docsPlugin from '@your-alint-config/docs-rules'
 
-import { defineConfig } from '@alint-js/core'
+import { defineConfig } from '@alint-js/cli'
 
 export default defineConfig([
   {
@@ -401,9 +443,9 @@ defineRule({
 
 | Package | Purpose |
 | --- | --- |
-| [`@alint-js/cli`](https://github.com/moeru-ai/alint/tree/main/packages/cli) | CLI entrypoint, setup commands, reporters, output inspection, and stats commands. |
-| [`@alint-js/config`](https://github.com/moeru-ai/alint/tree/main/packages/config) | Config loading, setup TOML parsing, config paths, and ignore defaults. |
-| [`@alint-js/core`](https://github.com/moeru-ai/alint/tree/main/packages/core) | Public DSL, run engine, source runtime, model resolution, diagnostics, cache, and agent contracts. |
+| [`@alint-js/cli`](https://github.com/moeru-ai/alint/tree/main/packages/cli) | CLI entrypoint, user-facing config facade, setup commands, reporters, output inspection, and stats commands. |
+| [`@alint-js/config`](https://github.com/moeru-ai/alint/tree/main/packages/config) | Lower-level config loading, setup TOML parsing, config paths, and ignore defaults for tools. |
+| [`@alint-js/core`](https://github.com/moeru-ai/alint/tree/main/packages/core) | SDK and run engine for plugins, rules, source runtime, model resolution, diagnostics, cache, and agent contracts. |
 | [`@alint-js/agent-apeira`](https://github.com/moeru-ai/alint/tree/main/packages/agent-apeira) | Apeira-backed `AgentAdapter`. |
 | [`@alint-js/agent-pi`](https://github.com/moeru-ai/alint/tree/main/packages/agent-pi) | Pi-backed `AgentAdapter`. |
 | [`@alint-js/plugin-example`](https://github.com/moeru-ai/alint/tree/main/packages/plugin-example) | Example TypeScript/JavaScript model-backed rules. |

package/dist/bin/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as executeCli } from "../cli-B-E-qUMa.mjs";
+import { t as executeCli } from "../cli-Dey9TSc8.mjs";
 import process from "node:process";
 //#region src/bin/index.ts
 executeCli(process.argv, {

package/dist/{cli-B-E-qUMa.mjs → cli-Dey9TSc8.mjs}

@@ -1,7 +1,7 @@
 import process from "node:process";
 import { inspect } from "node:util";
 import { cac } from "cac";
-import { getGlobalSetupConfigPath, getProjectSetupConfigPath, getStatsDir, loadAlintConfig, loadSetupConfig, mergeSetupConfigs, writeSetupConfig } from "@alint-js/config";
+import { getGlobalSetupConfigPath, getProjectSetupConfigPath, getStatsDir, installStaticPlugins, loadAlintConfig, loadSetupConfig, mergeSetupConfigs, writeSetupConfig } from "@alint-js/config";
 import { AlintRunError, hasDiscoveryFilePatterns, matchesDiscoveryFile, normalizeConfig, resolveConfigForFile, runAlint } from "@alint-js/core";
 import { isAbsolute, join, relative, resolve } from "pathe";
 import { getBorderCharacters, table } from "table";
@@ -14,7 +14,7 @@ import Gitignore from "gitignore-fs";
 import { Minimatch, minimatch } from "minimatch";
 import { errorMessageFrom as errorMessageFrom$1 } from "@moeru/std";
 //#region package.json
-var version = "0.0.19";
+var version = "0.0.21";
 //#endregion
 //#region src/cli/commands/command.ts
 function defineCommand(node) {
@@ -226,13 +226,39 @@ async function runConfigInspectCommand(file, configPath, io) {
 }
 //#endregion
 //#region src/cli/provider-registry.ts
+const providerSetupSources = [
+	{
+		defaultEndpoint: "http://127.0.0.1:8317/v1",
+		defaultProviderId: "CLIProxyAPI",
+		label: "CLIProxyAPI",
+		probeModels: true,
+		value: "cliProxyApi"
+	},
+	{
+		label: "Custom OpenAI-compatible provider",
+		probeModels: true,
+		value: "custom"
+	},
+	{
+		defaultEndpoint: "http://localhost:11434/v1",
+		label: "Ollama",
+		probeModels: true,
+		value: "ollama"
+	},
+	{
+		label: "Manual model entry",
+		probeModels: false,
+		value: "manual"
+	}
+];
 function buildModelsUrl(endpoint) {
 	return new URL("models", endpoint.endsWith("/") ? endpoint : `${endpoint}/`).toString();
 }
 function createProviderId(endpoint, existingIds) {
 	let base = "provider";
 	try {
-		base = new URL(endpoint).hostname.replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "").toLowerCase() || "provider";
+		const url = new URL(endpoint);
+		base = findProviderSetupSourceByEndpoint(url)?.defaultProviderId ?? (url.hostname.replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "").toLowerCase() || "provider");
 	} catch {
 		base = "provider";
 	}
@@ -245,6 +271,13 @@ function createProviderId(endpoint, existingIds) {
 function findModel(config, request) {
 	return flattenModels(config).find(({ model }) => model.id === request || model.name === request || (model.aliases ?? []).includes(request));
 }
+function findProviderSetupSource(value) {
+	return providerSetupSources.find((source) => source.value === value);
+}
+function findProviderSetupSourceByEndpoint(endpoint) {
+	const normalizedEndpoint = endpoint instanceof URL ? endpoint.toString() : new URL(endpoint).toString();
+	return providerSetupSources.find((source) => source.defaultEndpoint !== void 0 && new URL(source.defaultEndpoint).toString() === normalizedEndpoint);
+}
 function flattenModels(config) {
 	return config.providers.flatMap((provider) => provider.models.map((model) => ({
 		model,
@@ -1639,6 +1672,46 @@ const output = defineCommand({
 	name: "output"
 });
 //#endregion
+//#region src/cli/commands/plugin/index.ts
+const plugin = defineCommand({
+	children: [defineCommand({
+		action: async (context, options) => {
+			const result = await installStaticPlugins({
+				configFile: options.config,
+				cwd: context.io.cwd,
+				registry: options.registry
+			});
+			if (result.configuredPluginCount === 0) {
+				context.io.stdout.write("No static plugins configured. Wrote empty plugin lock.\n");
+				return 0;
+			}
+			context.io.stdout.write(`Installed packages: ${result.installedPackageCount}, local directories: ${result.installedLocalDirectoryCount}.\n`);
+			return 0;
+		},
+		description: "Install plugins from static configs",
+		examples: [
+			["# Install plugins referenced by static configs", "alint plugin install"].join("\n"),
+			["# Install using a custom registry", "alint plugin install --registry https://registry.npmjs.org/"].join("\n"),
+			["# Install a local directory configured as ./plugins/local-plugin", "alint plugin install"].join("\n")
+		],
+		help: ["Install remote packages or local directories from static configs.", "Remote packages are extracted into the project plugin store. Local directories are installed in place. Both are recorded in `.alint/plugins/lock.json`."].join("\n\n"),
+		name: "install",
+		options: [{
+			description: "Npm registry URL",
+			flags: "--registry <url>"
+		}]
+	})],
+	description: "Install remote packages or local directories from static configs",
+	examples: [["# Install remote packages or local directories from static configs", "alint plugin install"].join("\n"), [
+		"# Install a local plugin directory from alint.config.toml",
+		"[[config.group]]",
+		"[config.group.plugins]",
+		"local = \"./plugins/local-plugin\""
+	].join("\n")],
+	help: ["Install remote packages or local directories from static configs.", "Use `plugin install` after adding or changing plugin sources."].join("\n\n"),
+	name: "plugin"
+});
+//#endregion
 //#region src/cli/commands/setup/interactive.ts
 const nonTtyMessage = "interactive setup requires a TTY. Use -N/--no-interactive with --provider-id and --provider-endpoint.\n";
 const backValue = "__alint_back__";
@@ -1682,20 +1755,10 @@ async function runInteractiveSetup(io) {
 		if (step === "source") {
 			const source = await prompts.select({
 				message: "Choose provider setup mode.",
-				options: withBackOption([
-					{
-						label: "Custom OpenAI-compatible provider",
-						value: "custom"
-					},
-					{
-						label: "Ollama",
-						value: "ollama"
-					},
-					{
-						label: "Manual model entry",
-						value: "manual"
-					}
-				])
+				options: withBackOption(providerSetupSources.map(({ label, value }) => ({
+					label,
+					value
+				})))
 			});
 			if (prompts.isCancel(source)) return cancelPrompt();
 			if (source === backValue) {
@@ -1707,7 +1770,9 @@ async function runInteractiveSetup(io) {
 			continue;
 		}
 		if (step === "endpoint") {
-			const endpoint = await promptEndpoint(prompts, draft.source ?? "custom");
+			const setupSource = findProviderSetupSource(draft.source ?? "custom");
+			if (setupSource === void 0) return cancelPrompt();
+			const endpoint = await promptEndpoint(prompts, setupSource);
 			if (prompts.isCancel(endpoint)) return cancelPrompt();
 			if (typeof endpoint !== "string") return cancelPrompt();
 			if (isBackInput(endpoint)) {
@@ -1759,7 +1824,7 @@ async function runInteractiveSetup(io) {
 			}
 			draft.headerInput = headerInput;
 			draft.headers = parseHeaderList(splitHeaderInput(headerInput));
-			draft.discoveredModels = draft.source === "manual" ? [] : await probeModelsWithSpinner(prompts, draft.endpoint ?? "", draft.headers);
+			draft.discoveredModels = findProviderSetupSource(draft.source ?? "custom")?.probeModels === false ? [] : await probeModelsWithSpinner(prompts, draft.endpoint ?? "", draft.headers);
 			step = "models";
 			continue;
 		}
@@ -1862,9 +1927,9 @@ async function probeModelsWithSpinner(prompts, endpoint, headers) {
 }
 async function promptEndpoint(prompts, source) {
 	return prompts.text({
-		defaultValue: source === "ollama" ? "http://localhost:11434/v1" : void 0,
+		defaultValue: source.defaultEndpoint,
 		message: "Provider endpoint",
-		placeholder: source === "ollama" ? "http://localhost:11434/v1; type .. to go back" : "https://example.test/v1; type .. to go back",
+		placeholder: `${source.defaultEndpoint ?? "https://example.test/v1"}; type .. to go back`,
 		validate: (value) => isBackInput(value ?? "") || (value ?? "").trim().length > 0 ? void 0 : "Provider endpoint is required."
 	});
 }
@@ -2052,6 +2117,7 @@ function statsLocation(stats) {
 const commandTree = [
 	setup,
 	config,
+	plugin,
 	output,
 	defineCommand({
 		action: (context, options) => runStatsCommand(options, context.io),

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { Diagnostic, RunResult } from "@alint-js/core";
+import { ignorePatternsAIAgents, ignorePatternsBuildOutputs, ignorePatternsCaches, ignorePatternsCommon, ignorePatternsEslintDefaults, ignorePatternsGenerated } from "@alint-js/config";
+import { AlintConfig, AlintConfigItem, Diagnostic, RunResult, RunnerConfig, defineConfig } from "@alint-js/core";
 
 //#region src/cli/types.d.ts
 interface CliIo {
@@ -35,4 +36,4 @@ interface StylishReporterOptions {
 }
 declare function formatStylish(input: Diagnostic[] | RunResult, options?: StylishReporterOptions): string;
 //#endregion
-export { type CliIo, type ReporterName, executeCli, formatDiagnostics, formatJson, formatStylish };
+export { type AlintConfig, type AlintConfigItem, type CliIo, type ReporterName, type RunnerConfig, defineConfig, executeCli, formatDiagnostics, formatJson, formatStylish, ignorePatternsAIAgents, ignorePatternsBuildOutputs, ignorePatternsCaches, ignorePatternsCommon, ignorePatternsEslintDefaults, ignorePatternsGenerated };

package/dist/index.mjs

@@ -1,2 +1,4 @@
-import { i as formatJson, n as formatDiagnostics, r as formatStylish, t as executeCli } from "./cli-B-E-qUMa.mjs";
-export { executeCli, formatDiagnostics, formatJson, formatStylish };
+import { i as formatJson, n as formatDiagnostics, r as formatStylish, t as executeCli } from "./cli-Dey9TSc8.mjs";
+import { ignorePatternsAIAgents, ignorePatternsBuildOutputs, ignorePatternsCaches, ignorePatternsCommon, ignorePatternsEslintDefaults, ignorePatternsGenerated } from "@alint-js/config";
+import { defineConfig } from "@alint-js/core";
+export { defineConfig, executeCli, formatDiagnostics, formatJson, formatStylish, ignorePatternsAIAgents, ignorePatternsBuildOutputs, ignorePatternsCaches, ignorePatternsCommon, ignorePatternsEslintDefaults, ignorePatternsGenerated };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alint-js/cli",
   "type": "module",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -25,8 +25,8 @@
     "pathe": "^2.0.3",
     "table": "^6.9.0",
     "tinyrainbow": "^3.1.0",
-    "@alint-js/core": "0.0.19",
-    "@alint-js/config": "0.0.19"
+    "@alint-js/config": "0.0.21",
+    "@alint-js/core": "0.0.21"
   },
   "devDependencies": {
     "@pnpm/find-workspace-dir": "^1000.1.5",