@alint-js/cli 0.0.20 → 0.0.22

package/README.md

@@ -274,6 +274,41 @@ 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.
 
+#### Declarative local rule plugins
+
+For simple prompt-backed rules, a local plugin directory can omit `package.json` and contain one or more `rule.alint.*` files:
+
+```toml
+# rules/architecture/semantic/rule.alint.toml
+name = "semantic-boundary"
+builtInAgent = "basic-structured"
+instruction = """
+Find semantic boundary problems in the reviewed source.
+Report concrete findings with line numbers and short suggestions.
+"""
+includeFiles = [ "src/**/*.py" ]
+excludeFiles = [
+  "**/*_test.py",
+  "**/vendor/**",
+]
+```
+
+Reference the directory through the same static `plugins` table:
+
+```toml
+[[config.group]]
+files = [ "src/**/*.py" ]
+language = "text/plain"
+
+[config.group.plugins]
+arch = "./rules/architecture"
+
+[config.group.rules]
+"arch/semantic-boundary" = "warn"
+```
+
+`name` becomes the local rule id. `builtInAgent` can be `basic-structured` for a prompt-only structured-output rule or `basic-coding-agent` for a small built-in agent with filesystem tools. `includeFiles` and `excludeFiles` define where diagnostics may be reported; they do not limit what `basic-coding-agent` can inspect.
+
 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.

package/dist/bin/index.mjs

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

package/dist/{cli-CGvIT3NA.mjs → cli-CmLooFry.mjs}

@@ -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.20";
+var version = "0.0.22";
 //#endregion
 //#region src/cli/commands/command.ts
 function defineCommand(node) {
@@ -200,6 +200,7 @@ function shouldSkipOptionValue(arg) {
 		"--rule-concurrency",
 		"--since",
 		"--timeout-ms",
+		"-c",
 		"-f",
 		"-l"
 	].includes(arg);
@@ -226,13 +227,40 @@ 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);
+		const source = findProviderSetupSourceByEndpoint(url);
+		base = normalizeProviderIdBase(source?.defaultProviderId ?? source?.label ?? url.hostname);
 	} catch {
 		base = "provider";
 	}
@@ -245,6 +273,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,
@@ -329,6 +364,9 @@ function formatTable(rows) {
 		drawHorizontalLine: () => false
 	});
 }
+function normalizeProviderIdBase(value) {
+	return value.replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "").toLowerCase() || "provider";
+}
 //#endregion
 //#region src/cli/commands/config/setup-config.ts
 async function loadMergedSetupConfig(io) {
@@ -1682,6 +1720,53 @@ const plugin = defineCommand({
 //#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__";
+function applyDefaultAlias(config, target) {
+	return {
+		...config,
+		providers: config.providers.map((provider) => ({
+			...provider,
+			headers: provider.headers === void 0 ? void 0 : { ...provider.headers },
+			models: provider.models.map((model) => {
+				const aliasesWithoutDefault = (model.aliases ?? []).filter((alias) => alias !== "default");
+				const aliases = provider.id === target.providerId && model.id === target.modelId ? [...aliasesWithoutDefault, "default"] : aliasesWithoutDefault;
+				return {
+					...model,
+					aliases: aliases.length > 0 ? aliases : void 0,
+					capabilities: model.capabilities === void 0 ? void 0 : [...model.capabilities],
+					defaultParams: model.defaultParams === void 0 ? void 0 : { ...model.defaultParams }
+				};
+			})
+		}))
+	};
+}
+function createDefaultModelCandidates(config, newProviderId, newModelIds) {
+	const candidates = [];
+	const seen = /* @__PURE__ */ new Set();
+	const newModelIdSet = new Set(newModelIds);
+	const allModels = config.providers.flatMap((provider) => provider.models.map((model) => ({
+		isCurrentDefault: (model.aliases ?? []).includes("default"),
+		isNew: provider.id === newProviderId && newModelIdSet.has(model.id),
+		model,
+		provider,
+		value: createDefaultModelCandidateValue(provider.id, model.id)
+	})));
+	const addCandidate = (candidate) => {
+		if (candidate === void 0 || seen.has(candidate.value)) return;
+		seen.add(candidate.value);
+		candidates.push({
+			isCurrentDefault: candidate.isCurrentDefault,
+			isNew: candidate.isNew,
+			label: `${candidate.provider.id} / ${candidate.model.id}`,
+			modelId: candidate.model.id,
+			providerId: candidate.provider.id,
+			value: candidate.value
+		});
+	};
+	addCandidate(allModels.find((candidate) => candidate.isCurrentDefault));
+	for (const modelId of newModelIds) addCandidate(allModels.find((candidate) => candidate.provider.id === newProviderId && candidate.model.id === modelId));
+	for (const candidate of allModels) addCandidate(candidate);
+	return candidates;
+}
 function formatProbeModelsFailure(endpoint, error) {
 	const hint = endpoint.startsWith("https://localhost:11434") ? " Ollama usually uses http://localhost:11434/v1." : "";
 	return `Could not probe models: ${errorMessageFrom(error)}.${hint}`;
@@ -1722,20 +1807,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) {
@@ -1747,7 +1822,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)) {
@@ -1761,9 +1838,8 @@ async function runInteractiveSetup(io) {
 		if (step === "providerId") {
 			const existingConfig = await loadSetupConfig(getConfigPath(io, draft.scope ?? "global"));
 			const providerId = await prompts.text({
-				defaultValue: draft.providerId ?? createProviderId(draft.endpoint ?? "", new Set(existingConfig.providers.map((provider) => provider.id))),
-				message: "Provider id",
-				placeholder: "Type .. to go back",
+				initialValue: draft.providerId ?? createProviderId(draft.endpoint ?? "", new Set(existingConfig.providers.map((provider) => provider.id))),
+				message: "Provider id (type .. to go back)",
 				validate: (value) => isBackInput(value ?? "") || (value ?? "").trim().length > 0 ? void 0 : "Provider id is required."
 			});
 			if (prompts.isCancel(providerId)) return cancelPrompt();
@@ -1778,9 +1854,9 @@ async function runInteractiveSetup(io) {
 		}
 		if (step === "headers") {
 			const headerInput = await prompts.text({
-				defaultValue: draft.headerInput ?? "",
-				message: "Headers",
-				placeholder: "Authorization=Bearer token, X-Test=true; type .. to go back",
+				initialValue: draft.headerInput,
+				message: "Headers (leave empty to skip; type .. to go back)",
+				placeholder: "Authorization=Bearer token, X-Test=true",
 				validate: (value) => {
 					if (isBackInput(value ?? "")) return;
 					try {
@@ -1799,7 +1875,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;
 		}
@@ -1816,26 +1892,69 @@ async function runInteractiveSetup(io) {
 			continue;
 		}
 		if (step === "defaultAlias") {
-			const addDefaultAlias = await prompts.select({
+			const defaultAliasAction = await prompts.select({
 				message: `Add alias "default" to ${draft.selectedModels?.[0]}?`,
-				options: withBackOption([{
-					label: "Yes",
-					value: "yes"
-				}, {
-					label: "No",
-					value: "no"
-				}])
+				options: withBackOption([
+					{
+						label: "Yes",
+						value: "yes"
+					},
+					{
+						label: "No",
+						value: "no"
+					},
+					{
+						label: "Select another",
+						value: "selectAnother"
+					}
+				])
 			});
-			if (prompts.isCancel(addDefaultAlias)) return cancelPrompt();
-			if (addDefaultAlias === backValue) {
+			if (prompts.isCancel(defaultAliasAction)) return cancelPrompt();
+			if (defaultAliasAction === backValue) {
 				step = "models";
 				continue;
 			}
-			draft.addDefaultAlias = addDefaultAlias === "yes";
+			if (defaultAliasAction === "selectAnother") {
+				step = "selectDefaultModel";
+				continue;
+			}
+			draft.defaultAliasTarget = defaultAliasAction === "yes" ? {
+				modelId: draft.selectedModels?.[0] ?? "",
+				providerId: (draft.providerId ?? "").trim()
+			} : void 0;
+			step = "confirm";
+			continue;
+		}
+		if (step === "selectDefaultModel") {
+			const existingConfig = await loadSetupConfig(getConfigPath(io, draft.scope ?? "global"));
+			const draftProvider = createProviderConfig((draft.providerId ?? "").trim(), (draft.endpoint ?? "").trim(), draft.headers, draft.selectedModels ?? []);
+			const candidates = createDefaultModelCandidates(mergeSetupConfigs(existingConfig, {
+				providers: [draftProvider],
+				version: 1
+			}), draftProvider.id, draft.selectedModels ?? []);
+			const defaultModel = await prompts.select({
+				message: "Select default model",
+				options: withBackOption(candidates.map((candidate) => ({
+					hint: candidate.isCurrentDefault ? "current default" : candidate.isNew ? "new" : void 0,
+					label: candidate.label,
+					value: candidate.value
+				})))
+			});
+			if (prompts.isCancel(defaultModel)) return cancelPrompt();
+			if (defaultModel === backValue) {
+				step = "defaultAlias";
+				continue;
+			}
+			const candidate = candidates.find((item) => item.value === defaultModel);
+			if (candidate === void 0) return cancelPrompt();
+			draft.defaultAliasTarget = {
+				modelId: candidate.modelId,
+				providerId: candidate.providerId
+			};
 			step = "confirm";
 			continue;
 		}
-		const nextProvider = createProviderConfig((draft.providerId ?? "").trim(), (draft.endpoint ?? "").trim(), draft.headers, draft.selectedModels ?? [], draft.addDefaultAlias ?? true);
+		const nextProvider = createProviderConfig((draft.providerId ?? "").trim(), (draft.endpoint ?? "").trim(), draft.headers, draft.selectedModels ?? []);
 		const confirmed = await prompts.select({
 			message: [
 				`Write ${draft.scope} setup config?`,
@@ -1858,10 +1977,11 @@ async function runInteractiveSetup(io) {
 		}
 		if (confirmed === "no") return cancelPrompt();
 		const configPath = getConfigPath(io, draft.scope ?? "global");
-		await writeSetupConfig(configPath, mergeSetupConfigs(await loadSetupConfig(configPath), {
+		const mergedConfig = mergeSetupConfigs(await loadSetupConfig(configPath), {
 			providers: [nextProvider],
 			version: 1
-		}));
+		});
+		await writeSetupConfig(configPath, draft.defaultAliasTarget === void 0 ? mergedConfig : applyDefaultAlias(mergedConfig, draft.defaultAliasTarget));
 		prompts.outro(`Wrote ${configPath}`);
 		return 0;
 	}
@@ -1872,13 +1992,15 @@ function withBackOption(options) {
 		value: backValue
 	}];
 }
-function createProviderConfig(providerId, endpoint, headers, modelIds, addDefaultAlias) {
+function createDefaultModelCandidateValue(providerId, modelId) {
+	return `${providerId}\u0000${modelId}`;
+}
+function createProviderConfig(providerId, endpoint, headers, modelIds) {
 	return {
 		endpoint,
 		headers,
 		id: providerId,
-		models: modelIds.map((modelId, index) => ({
-			aliases: index === 0 && addDefaultAlias ? ["default"] : void 0,
+		models: modelIds.map((modelId) => ({
 			id: modelId,
 			name: modelId
 		})),
@@ -1902,9 +2024,9 @@ async function probeModelsWithSpinner(prompts, endpoint, headers) {
 }
 async function promptEndpoint(prompts, source) {
 	return prompts.text({
-		defaultValue: source === "ollama" ? "http://localhost:11434/v1" : void 0,
-		message: "Provider endpoint",
-		placeholder: source === "ollama" ? "http://localhost:11434/v1; type .. to go back" : "https://example.test/v1; type .. to go back",
+		initialValue: source.defaultEndpoint,
+		message: "Provider endpoint (type .. to go back)",
+		placeholder: source.defaultEndpoint ?? "https://example.test/v1",
 		validate: (value) => isBackInput(value ?? "") || (value ?? "").trim().length > 0 ? void 0 : "Provider endpoint is required."
 	});
 }
@@ -2138,7 +2260,7 @@ async function executeCli(argv, io) {
 		pendingResult = result;
 		return result;
 	};
-	cli.option("--no-cache", "Disable cache for this run").option("--cache-location <path>", "Path to the alint cache file or directory").option("--config <path>", "Path to alint config file").option("--file-concurrency <count>", "Number of files to lint concurrently").option("--format <format>", "Reporter format", { default: "stylish" }).option("--model <model>", "Force a model override").option("-l, --lang <language>", "Ask model-backed rules to write diagnostics in this language").option("--progress", "Show run progress").option("--rule-concurrency <count>", "Number of rules to run concurrently within a file").option("--no-stats", "Do not record run stats for this run").option("--timeout-ms <ms>", "Rule execution timeout in milliseconds").version(version).help();
+	cli.option("--no-cache", "Disable cache for this run").option("--cache-location <path>", "Path to the alint cache file or directory").option("-c, --config <path>", "Path to alint config file").option("--file-concurrency <count>", "Number of files to lint concurrently").option("--format <format>", "Reporter format", { default: "stylish" }).option("--model <model>", "Force a model override").option("-l, --lang <language>", "Ask model-backed rules to write diagnostics in this language").option("--progress", "Show run progress").option("--rule-concurrency <count>", "Number of rules to run concurrently within a file").option("--no-stats", "Do not record run stats for this run").option("--timeout-ms <ms>", "Rule execution timeout in milliseconds").version(version).help();
 	registerCommandTree(cli, commandTree, {
 		globalOptions,
 		interceptConsoleOutput,

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { i as formatJson, n as formatDiagnostics, r as formatStylish, t as executeCli } from "./cli-CGvIT3NA.mjs";
+import { i as formatJson, n as formatDiagnostics, r as formatStylish, t as executeCli } from "./cli-CmLooFry.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.20",
+  "version": "0.0.22",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -25,18 +25,14 @@
     "pathe": "^2.0.3",
     "table": "^6.9.0",
     "tinyrainbow": "^3.1.0",
-    "@alint-js/core": "0.0.20",
-    "@alint-js/config": "0.0.20"
+    "@alint-js/config": "0.0.22",
+    "@alint-js/core": "0.0.22"
   },
   "devDependencies": {
     "@pnpm/find-workspace-dir": "^1000.1.5",
-    "@types/node": "^26.0.1",
     "local-pkg": "^1.2.1",
     "mlly": "^1.8.2",
-    "tinyexec": "^1.2.4",
-    "tsdown": "^0.22.3",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.9"
+    "tinyexec": "^1.2.4"
   },
   "scripts": {
     "alint": "node ./dist/bin/index.mjs",