@konvert7/klint 0.22.0 → 0.24.0

package/README.md

@@ -1,14 +1,21 @@
 # klint
 
-Architecture and type-aware linting for TypeScript projects.
+Architecture-as-Code linting for TypeScript, Python, and Swift projects.
 
-Biome and oxlint are excellent at syntax, style, and fast local correctness. klint handles the rules that need project context: layer boundaries, singleton ownership, forbidden patterns, custom repository policies, and type-aware checks that should block an AI agent or CI run before code lands.
+Biome, oxlint, Ruff, and SwiftLint are excellent at syntax, style, and fast local correctness. klint handles the rules that need project context: layer boundaries, singleton ownership, forbidden patterns, custom repository policies, and type-aware TypeScript checks that should block an AI agent or CI run before code lands.
 
 Use klint when "please follow AGENTS.md" is not strong enough. Put the rule in `klint.yaml`, run `klint`, and make the constraint executable.
 
 ## Install
 
-klint currently runs on Bun.
+For macOS native CLI usage:
+
+```sh
+brew tap konvert7/tap
+brew install klint
+```
+
+For TypeScript projects using Bun:
 
 ```sh
 bun add -d @konvert7/klint
@@ -190,7 +197,7 @@ arch:
       message: "Client code must not import server-only modules"
 ```
 
-`include` selects `.ts` files to lint. Patterns support `**` globs and `!` negation.
+`include` selects source files to lint. Patterns support `**` globs and `!` negation.
 
 `plugins` enables bundled rule groups. Today, `sonar` provides focused code-quality rules.
 
@@ -279,6 +286,83 @@ arch:
       message: "Use the auth module"
 ```
 
+### Python Architecture Checks
+
+The Rust engine can apply architecture rules to Python projects:
+
+```yaml
+include: ["src"]
+
+rules: {}
+
+arch:
+  layers:
+    jobs: ["src/app/jobs/**"]
+    lib: ["src/app/lib/**"]
+    config: ["src/app/config.py"]
+
+  imports:
+    - from: jobs
+      deny: lib
+      message: "Jobs must use service APIs, not import lib directly"
+
+  forbidden:
+    - pattern: "print("
+      in: jobs
+      message: "Use the logger"
+
+  singleton:
+    - pattern: "os.environ[\"API_KEY\"]"
+      only: "src/app/config.py"
+      in: ["src/**"]
+      message: "Use app config"
+```
+
+Python import checks support relative imports such as
+`from ..lib.auth import load_key` and project-resolvable absolute imports such
+as `from app.lib.auth import load_key`. External packages that do not resolve to
+project files, such as `requests`, are ignored. This is architecture
+enforcement, not full packaging or virtual-environment analysis.
+
+### Swift Architecture Checks
+
+The Rust engine can apply architecture rules to Swift projects:
+
+```yaml
+include: ["Sources"]
+
+rules: {}
+
+arch:
+  layers:
+    ui: ["Sources/App/UI/**"]
+    core: ["Sources/App/Core/**"]
+    config: ["Sources/App/Config/**"]
+
+  imports:
+    - from: ui
+      deny: core
+      message: "UI must use app services, not import Core directly"
+
+  forbidden:
+    - pattern: "URLSession.shared"
+      in: ui
+      message: "Use the networking client"
+
+  singleton:
+    - pattern: "ProcessInfo.processInfo.environment[\"API_KEY\"]"
+      only: "Sources/App/Config/AppConfig.swift"
+      in: ["Sources/**"]
+      message: "Use AppConfig"
+```
+
+Swift import checks parse declarations such as `import Core`,
+`@_exported import Core`, and `import struct Models.User`. Imported modules
+resolve against discovered project Swift directories and file stems. System or
+package modules that are not present in the project, such as `Foundation`, are
+ignored. This is architecture enforcement, not full SwiftPM or Xcode build graph
+analysis.
+
 ## Built-in Rules
 
 | Rule | Type-aware | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konvert7/klint",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Architecture-as-Code linter for TypeScript. Enforce layer boundaries, import rules, and singleton patterns in YAML.",
   "type": "module",
   "bin": {
@@ -64,10 +64,10 @@
     "zod": "^4.4.3"
   },
   "optionalDependencies": {
-    "@konvert7/klint-darwin-arm64": "0.22.0",
-    "@konvert7/klint-darwin-x64": "0.22.0",
-    "@konvert7/klint-linux-x64": "0.22.0",
-    "@konvert7/klint-win32-x64": "0.22.0"
+    "@konvert7/klint-darwin-arm64": "0.24.0",
+    "@konvert7/klint-darwin-x64": "0.24.0",
+    "@konvert7/klint-linux-x64": "0.24.0",
+    "@konvert7/klint-win32-x64": "0.24.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.7",

package/tools/generate-homebrew-formula.ts

@@ -0,0 +1,68 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+interface FormulaOptions {
+  version: string;
+  darwinArm64Sha: string;
+  darwinX64Sha: string;
+}
+
+export function homebrewFormula(options: FormulaOptions): string {
+  const version = options.version.replace(/^v/, "");
+
+  return `# typed: false
+# frozen_string_literal: true
+
+class Klint < Formula
+  desc "Architecture-as-Code linter for TypeScript, Python, and Swift projects"
+  homepage "https://github.com/konvert7/klint"
+  version "${version}"
+  license "MIT"
+
+  on_macos do
+    on_arm do
+      url "https://github.com/konvert7/klint/releases/download/native-v${version}/klint-${version}-darwin-arm64.tar.gz"
+      sha256 "${options.darwinArm64Sha}"
+    end
+
+    on_intel do
+      url "https://github.com/konvert7/klint/releases/download/native-v${version}/klint-${version}-darwin-x64.tar.gz"
+      sha256 "${options.darwinX64Sha}"
+    end
+  end
+
+  def install
+    binary = File.exist?("klint") ? "klint" : Dir["klint-*/klint"].first
+    odie "klint binary not found" unless binary
+    bin.install binary => "klint"
+  end
+
+  test do
+    assert_match "klint-rs", shell_output("#{bin}/klint --version")
+  end
+end
+`;
+}
+
+if (import.meta.main) {
+  const args = process.argv.slice(2);
+  const output = requireValue(args, "--output");
+  const formula = homebrewFormula({
+    version: requireValue(args, "--version"),
+    darwinArm64Sha: requireValue(args, "--darwin-arm64-sha"),
+    darwinX64Sha: requireValue(args, "--darwin-x64-sha"),
+  });
+
+  const path = resolve(output);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, formula);
+}
+
+function requireValue(args: string[], name: string): string {
+  const index = args.indexOf(name);
+  const value = index >= 0 ? args[index + 1] : undefined;
+  if (!value) {
+    throw new Error(`${name} is required`);
+  }
+  return value;
+}