@alint-js/cli 0.0.18 → 0.0.20

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-0CZLDTFP.mjs";
+import { t as executeCli } from "../cli-CGvIT3NA.mjs";
 import process from "node:process";
 //#region src/bin/index.ts
 executeCli(process.argv, {

package/dist/{cli-0CZLDTFP.mjs → cli-CGvIT3NA.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.18";
+var version = "0.0.20";
 //#endregion
 //#region src/cli/commands/command.ts
 function defineCommand(node) {
@@ -1639,6 +1639,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__";
@@ -2052,6 +2092,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-0CZLDTFP.mjs";
-export { executeCli, formatDiagnostics, formatJson, formatStylish };
+import { i as formatJson, n as formatDiagnostics, r as formatStylish, t as executeCli } from "./cli-CGvIT3NA.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.18",
+  "version": "0.0.20",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -25,8 +25,8 @@
     "pathe": "^2.0.3",
     "table": "^6.9.0",
     "tinyrainbow": "^3.1.0",
-    "@alint-js/config": "0.0.18",
-    "@alint-js/core": "0.0.18"
+    "@alint-js/core": "0.0.20",
+    "@alint-js/config": "0.0.20"
   },
   "devDependencies": {
     "@pnpm/find-workspace-dir": "^1000.1.5",