semlint-cli 0.1.0 → 0.1.1

package/README.md

@@ -21,6 +21,12 @@ pnpm build
 semlint check
 ```
 
+Scaffold a project config with automatic coding agent CLI detection:
+
+```bash
+semlint init
+```
+
 If running from source:
 
 ```bash
@@ -38,6 +44,7 @@ pnpm check
 - `--fail-on <error|warn|never>`: failure threshold (default `error`)
 - `--batch`: run all selected rules in one backend call
 - `--debug`: enable debug logs to stderr
+- `init --force`: overwrite an existing `semlint.json`
 
 Default diff behavior (without `--base`/`--head`) uses your local branch state:
 
@@ -92,6 +99,24 @@ Unknown fields are ignored.
 }
 ```
 
+## Config scaffolding and auto-detection
+
+Run:
+
+```bash
+semlint init
+```
+
+This creates `./semlint.json` and auto-detects installed coding agent CLIs in this priority order:
+
+1. `cursor` -> backend `cursor-cli`
+2. `claude` -> backend `claude-code`
+3. `codex` -> backend `codex-cli`
+
+If no known CLI is detected, Semlint falls back to `cursor-cli` + executable `cursor`.
+
+Use `semlint init --force` to overwrite an existing config file.
+
 ## Rule files
 
 Rule JSON files are loaded from `rules/`.

package/dist/cli.js

@@ -1,7 +1,26 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const init_1 = require("./init");
 const main_1 = require("./main");
+const HELP_TEXT = [
+    "Usage:",
+    "  semlint check [--backend <name>] [--model <name>] [--config <path>] [--format <text|json>] [--base <ref>] [--head <ref>] [--fail-on <error|warn|never>] [--batch] [--debug]",
+    "  semlint init [--force]",
+    "  semlint --help",
+    "",
+    "Commands:",
+    "  check   Run semantic lint rules against your git diff",
+    "  init    Create semlint.json with auto-detected agent backend",
+    "",
+    "Options:",
+    "  -h, --help   Show this help text"
+].join("\n");
+class HelpRequestedError extends Error {
+    constructor() {
+        super(HELP_TEXT);
+    }
+}
 const FLAGS_WITH_VALUES = new Set([
     "--backend",
     "--model",
@@ -18,9 +37,26 @@ function isFailOn(value) {
     return value === "error" || value === "warn" || value === "never";
 }
 function parseArgs(argv) {
+    if (argv.length === 0 || argv.includes("--help") || argv.includes("-h") || argv[0] === "help") {
+        throw new HelpRequestedError();
+    }
     const [command, ...rest] = argv;
-    if (!command || command !== "check") {
-        throw new Error("Usage: semlint check [--backend <name>] [--model <name>] [--config <path>] [--format <text|json>] [--base <ref>] [--head <ref>] [--fail-on <error|warn|never>] [--batch] [--debug]");
+    if (!command || (command !== "check" && command !== "init")) {
+        throw new Error(HELP_TEXT);
+    }
+    if (command === "init") {
+        const options = {
+            command: "init",
+            debug: false
+        };
+        for (const token of rest) {
+            if (token === "--force") {
+                options.force = true;
+                continue;
+            }
+            throw new Error(`Unknown flag for init: ${token}`);
+        }
+        return options;
     }
     const options = {
         command: "check",
@@ -81,13 +117,13 @@ function parseArgs(argv) {
 async function main() {
     try {
         const options = parseArgs(process.argv.slice(2));
-        const exitCode = await (0, main_1.runSemlint)(options);
+        const exitCode = options.command === "init" ? (0, init_1.scaffoldConfig)(options.force) : await (0, main_1.runSemlint)(options);
         process.exitCode = exitCode;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         process.stderr.write(`${message}\n`);
-        process.exitCode = 2;
+        process.exitCode = error instanceof HelpRequestedError ? 0 : 2;
     }
 }
 void main();

package/dist/init.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldConfig = scaffoldConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+function commandExists(command) {
+    const result = (0, node_child_process_1.spawnSync)(command, ["--version"], {
+        stdio: "ignore"
+    });
+    return result.status === 0 || result.status === 1;
+}
+function detectBackend() {
+    const candidates = [
+        {
+            executable: "cursor",
+            backend: "cursor-cli",
+            reason: "detected Cursor CLI"
+        },
+        {
+            executable: "claude",
+            backend: "claude-code",
+            reason: "detected Claude Code CLI"
+        },
+        {
+            executable: "codex",
+            backend: "codex-cli",
+            reason: "detected Codex CLI"
+        }
+    ];
+    for (const candidate of candidates) {
+        if (commandExists(candidate.executable)) {
+            return candidate;
+        }
+    }
+    return {
+        backend: "cursor-cli",
+        executable: "cursor",
+        reason: "no known agent CLI detected, using default Cursor setup"
+    };
+}
+function scaffoldConfig(force = false) {
+    const targetPath = node_path_1.default.join(process.cwd(), "semlint.json");
+    if (node_fs_1.default.existsSync(targetPath) && !force) {
+        process.stderr.write(`Refusing to overwrite existing ${targetPath}. Re-run with "semlint init --force" to replace it.\n`);
+        return 2;
+    }
+    const detected = detectBackend();
+    const scaffold = {
+        backend: detected.backend,
+        model: "auto",
+        budgets: {
+            timeout_ms: 120000
+        },
+        output: {
+            format: "text"
+        },
+        execution: {
+            batch: false
+        },
+        rules: {
+            disable: [],
+            severity_overrides: {}
+        },
+        backends: {
+            [detected.backend]: {
+                executable: detected.executable
+            }
+        }
+    };
+    node_fs_1.default.writeFileSync(targetPath, `${JSON.stringify(scaffold, null, 2)}\n`, "utf8");
+    process.stdout.write(`Created ${targetPath}\n`);
+    process.stdout.write(`Backend setup: ${detected.backend} (${detected.reason})\n`);
+    return 0;
+}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "semlint-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Semantic lint CLI — runs LLM-backed rules on your git diff and returns CI-friendly exit codes",
   "type": "commonjs",
   "main": "dist/main.js",
   "bin": {
-    "semlint": "dist/cli.js"
+    "semlint-cli": "dist/cli.js"
   },
   "files": [
     "dist",