@sirius-mcp/mcp 1.4.0 → 1.5.0

package/LICENSE

@@ -0,0 +1,7 @@
+Sirius MCP Server License
+Copyright (c) 2026 Sirius MCP Contributors
+
+Proprietary Software.
+Free for solo developer and local development use.
+Distribution and enterprise use are subject to commercial licensing terms.
+See https://siriusmcp.dev for more details.

package/README.md

@@ -0,0 +1,177 @@
+# @sirius-mcp/mcp
+
+> **Sirius MCP** — Persistent project-level context memory for AI coding agents.
+
+[![npm version](https://img.shields.io/npm/v/@sirius-mcp/mcp.svg)](https://www.npmjs.com/package/@sirius-mcp/mcp)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen.svg)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-1.29.0-blue.svg)](https://modelcontextprotocol.io)
+
+Sirius is a Model Context Protocol (MCP) server that gives your AI agent (Claude Code, Cursor, Windsurf, OpenCode, VS Code, Antigravity) long-term, auditable project memory. It stores architecture decisions, features, and business rules in a plain-text `.context/` markdown tree directly in your repository, indexed locally with SQLite FTS5.
+
+Solo use is completely free with zero sign-up or license key needed.
+
+---
+
+## Quick Start
+
+Run or configure Sirius directly using `npx`:
+
+```json
+{
+  "mcpServers": {
+    "sirius": {
+      "command": "npx",
+      "args": ["-y", "@sirius-mcp/mcp"]
+    }
+  }
+}
+```
+
+`-y` automatically accepts the package installation prompt so the agent startup is non-blocking.
+
+---
+
+## IDE & MCP Client Configuration
+
+Add Sirius to your preferred environment:
+
+### Claude Code (`.mcp.json` or `~/.claude.json`)
+```json
+{
+  "mcpServers": {
+    "sirius": {
+      "command": "npx",
+      "args": ["-y", "@sirius-mcp/mcp"]
+    }
+  }
+}
+```
+
+### Cursor (`.cursor/mcp.json` or Settings > Features > MCP)
+```json
+{
+  "mcpServers": {
+    "sirius": {
+      "command": "npx",
+      "args": ["-y", "@sirius-mcp/mcp"]
+    }
+  }
+}
+```
+
+### VS Code (Cline / Roo Code)
+In your Cline / Roo Code MCP settings (`cline_mcp_settings.json`):
+```json
+{
+  "mcpServers": {
+    "sirius": {
+      "command": "npx",
+      "args": ["-y", "@sirius-mcp/mcp"]
+    }
+  }
+}
+```
+
+### Windsurf (`~/.codeium/windsurf/mcp_config.json`)
+```json
+{
+  "mcpServers": {
+    "sirius": {
+      "command": "npx",
+      "args": ["-y", "@sirius-mcp/mcp"]
+    }
+  }
+}
+```
+
+### OpenCode (`opencode.json`)
+```json
+{
+  "mcp": {
+    "sirius": {
+      "type": "local",
+      "command": ["npx", "-y", "@sirius-mcp/mcp"],
+      "enabled": true
+    }
+  }
+}
+```
+
+---
+
+## Docker Alternative
+
+If you prefer running Sirius inside a container (for persistent servers or VPS deployments):
+
+```bash
+docker run -i --rm \
+  --pull=always \
+  -p 127.0.0.1:4200:4200 \
+  -v "$PWD:/project" \
+  -e SIRIUS_PROJECT_ROOT=/project \
+  ghcr.io/sirius-mcp/sirius-mcp:latest
+```
+
+---
+
+## MCP Tools Provided
+
+Once connected, your AI agent gains access to these primary context tools:
+
+| Tool | Description |
+| --- | --- |
+| `context_list` | Lists all documents in the project memory (filterable by `type`, `status`, `path_prefix`). |
+| `context_get` | Retrieves the full markdown content and frontmatter metadata of a specific document. |
+| `context_search` | Performs full-text search (SQLite FTS5) over all indexed documents. |
+| `context_upsert` | Creates or updates a context document (feature, decision, business-rule, architecture). |
+| `context_crawl` | Crawls codebase or external documentation into context memory. |
+| `reindex` | Rebuilds the local SQLite search index directly from the `.context/` markdown files. |
+| `project_init` | Bootstraps a fresh `.context/` directory in a new repository. |
+
+---
+
+## MCP Resources Provided
+
+- `context://document/{type}/{id}` — Direct URI to read any context document.
+- `context://system/update-status` — Real-time update check and release metadata signal.
+
+---
+
+## Embedded Living Architecture Web Portal
+
+Sirius includes a built-in web portal that visualizes your architecture blueprints, dependencies, decisions, and system rules in real-time.
+
+When Sirius runs, navigate to:
+```
+http://localhost:4200
+```
+to explore your project's living knowledge base visually.
+
+---
+
+## Storage & Invariants
+
+- **Markdown as Single Source of Truth**: Documents live in `.context/` inside your project git repository.
+- **Auditable & Git-friendly**: Every decision or rule change can be committed, reviewed in PRs, and tracked in git history.
+- **Ephemeral Index**: The local SQLite database (`.context/.index/sirius.db`) is completely disposable and gitignored; it can be rebuilt instantly with `reindex`.
+- **Zero-network by default**: Solo tier runs completely local on your machine.
+
+---
+
+## Requirements
+
+- **Node.js**: >= 22.0.0 (npm included)
+
+---
+
+## Documentation
+
+Full documentation, guides, and deployment recipes are available at:
+- Documentation: [siriusmcp.dev/docs/deploy](https://siriusmcp.dev/docs/deploy)
+- GitHub Repository: [github.com/sirius-mcp/sirius-mcp](https://github.com/sirius-mcp/sirius-mcp)
+
+---
+
+## License
+
+Proprietary. Free for solo and local developer use.

package/dist/adapters/sqlite/ftsIndex.js

@@ -59,11 +59,11 @@ export class FtsIndexAdapter {
         if (!safeQuery) {
             return [];
         }
-        const stmt = this.db.prepare(`SELECT id, type, status, title, path,
-              snippet(documents_fts, 4, '<<<', '>>>', '...', 32) as snippet
-       FROM documents_fts
-       WHERE documents_fts MATCH ?
-       ORDER BY rank
+        const stmt = this.db.prepare(`SELECT id, type, status, title, path,
+              snippet(documents_fts, 4, '<<<', '>>>', '...', 32) as snippet
+       FROM documents_fts
+       WHERE documents_fts MATCH ?
+       ORDER BY rank
        LIMIT ?`);
         let rows = stmt.all(safeQuery, limit);
         if (rows.length === 0) {
@@ -88,14 +88,14 @@ export class FtsIndexAdapter {
     }
     rebuild(docs) {
         this.ensureOpen();
-        const createFts = this.db.prepare(`CREATE VIRTUAL TABLE IF NOT EXISTS documents_fts USING fts5(
-        id UNINDEXED, type UNINDEXED, status UNINDEXED,
-        title, body, path UNINDEXED,
-        tokenize = 'porter unicode61'
+        const createFts = this.db.prepare(`CREATE VIRTUAL TABLE IF NOT EXISTS documents_fts USING fts5(
+        id UNINDEXED, type UNINDEXED, status UNINDEXED,
+        title, body, path UNINDEXED,
+        tokenize = 'porter unicode61'
       )`);
         const dropFts = this.db.prepare("DROP TABLE IF EXISTS documents_fts");
         const insertStmt = this.db.prepare("INSERT INTO documents_fts (id, type, status, title, body, path) VALUES (?, ?, ?, ?, ?, ?)");
-        const setVersion = this.db.prepare(`INSERT INTO index_meta (key, value) VALUES ('schema_version', ?)
+        const setVersion = this.db.prepare(`INSERT INTO index_meta (key, value) VALUES ('schema_version', ?)
        ON CONFLICT(key) DO UPDATE SET value = excluded.value`);
         const transaction = this.db.transaction((documents) => {
             dropFts.run();
@@ -110,14 +110,14 @@ export class FtsIndexAdapter {
         this._needsRebuild = false;
     }
     initializeSchema() {
-        this.db.exec(`CREATE TABLE IF NOT EXISTS index_meta (
-        key TEXT PRIMARY KEY,
-        value TEXT NOT NULL
+        this.db.exec(`CREATE TABLE IF NOT EXISTS index_meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
       )`);
-        const createFts = this.db.prepare(`CREATE VIRTUAL TABLE IF NOT EXISTS documents_fts USING fts5(
-        id UNINDEXED, type UNINDEXED, status UNINDEXED,
-        title, body, path UNINDEXED,
-        tokenize = 'porter unicode61'
+        const createFts = this.db.prepare(`CREATE VIRTUAL TABLE IF NOT EXISTS documents_fts USING fts5(
+        id UNINDEXED, type UNINDEXED, status UNINDEXED,
+        title, body, path UNINDEXED,
+        tokenize = 'porter unicode61'
       )`);
         createFts.run();
         const row = this.db

package/dist/installer/backup.d.ts

@@ -0,0 +1,4 @@
+export declare function formatBackupTimestamp(date?: Date): string;
+export declare function createBackup(filePath: string): Promise<string | null>;
+export declare function atomicWrite(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/installer/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/installer/backup.ts"],"names":[],"mappings":"AAIA,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CASrE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkB3E;AAkCD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BlF"}

package/dist/installer/backup.js

@@ -0,0 +1,88 @@
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+export function formatBackupTimestamp(date = new Date()) {
+    const pad = (n) => n.toString().padStart(2, "0");
+    const yyyy = date.getFullYear();
+    const mm = pad(date.getMonth() + 1);
+    const dd = pad(date.getDate());
+    const hh = pad(date.getHours());
+    const min = pad(date.getMinutes());
+    const ss = pad(date.getSeconds());
+    return `${yyyy}${mm}${dd}${hh}${min}${ss}`;
+}
+export async function createBackup(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const parentDir = path.dirname(filePath);
+    const baseName = path.basename(filePath);
+    let timestamp = formatBackupTimestamp();
+    let backupPath = path.join(parentDir, `${baseName}.bak.${timestamp}`);
+    let counter = 1;
+    while (fs.existsSync(backupPath)) {
+        timestamp = `${formatBackupTimestamp()}_${counter++}`;
+        backupPath = path.join(parentDir, `${baseName}.bak.${timestamp}`);
+    }
+    await fs.promises.copyFile(filePath, backupPath);
+    return backupPath;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function writeAndSyncTemp(tempPath, content) {
+    const handle = await fs.promises.open(tempPath, "w");
+    try {
+        await handle.writeFile(content, "utf8");
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function tryRenameWithBackoff(tempPath, targetPath) {
+    const backoffs = [100, 200, 400];
+    for (let i = 0; i <= backoffs.length; i++) {
+        try {
+            await fs.promises.rename(tempPath, targetPath);
+            return true;
+        }
+        catch (err) {
+            const code = err?.code;
+            const isLockError = code === "EBUSY" || code === "EPERM";
+            if (!isLockError || i === backoffs.length) {
+                break;
+            }
+            await sleep(backoffs[i]);
+        }
+    }
+    return false;
+}
+export async function atomicWrite(filePath, content) {
+    const parentDir = path.dirname(filePath);
+    await fs.promises.mkdir(parentDir, { recursive: true, mode: 0o700 });
+    const tempPath = path.join(parentDir, `${path.basename(filePath)}.tmp.${process.pid}.${crypto.randomUUID()}`);
+    try {
+        await writeAndSyncTemp(tempPath, content);
+        if (fs.existsSync(filePath)) {
+            const stat = await fs.promises.stat(filePath);
+            await fs.promises.chmod(tempPath, stat.mode);
+        }
+        const renamed = await tryRenameWithBackoff(tempPath, filePath);
+        if (!renamed) {
+            // Fallback: direct in-place buffered write
+            await fs.promises.writeFile(filePath, content, "utf8");
+        }
+    }
+    finally {
+        if (fs.existsSync(tempPath)) {
+            try {
+                await fs.promises.unlink(tempPath);
+            }
+            catch {
+                // cleanup best-effort
+            }
+        }
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/installer/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/installer/backup.ts"],"names":[],"mappings":"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"}

package/dist/installer/cli-parser.d.ts

@@ -0,0 +1,3 @@
+import { type InstallerOptions } from "./types.js";
+export declare function parseInstallerArgs(args: string[]): InstallerOptions;
+//# sourceMappingURL=cli-parser.d.ts.map

package/dist/installer/cli-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.d.ts","sourceRoot":"","sources":["../../src/installer/cli-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAkDpB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA6BnE"}

package/dist/installer/cli-parser.js

@@ -0,0 +1,71 @@
+import {} from "./types.js";
+function parseValuedFlag(arg, val, options) {
+    if (arg === "--ide" || arg === "--clients") {
+        options.targets = val?.split(",").map((s) => s.trim().toLowerCase());
+        return true;
+    }
+    if (arg === "--category") {
+        options.category = val?.toLowerCase();
+        return true;
+    }
+    if (arg === "--scope") {
+        options.scope = val?.toLowerCase() ?? "global";
+        return true;
+    }
+    return false;
+}
+function parseBooleanFlag(arg, options) {
+    if (arg === "--all") {
+        options.all = true;
+        return true;
+    }
+    if (arg === "--yes" || arg === "-y") {
+        options.yes = true;
+        return true;
+    }
+    if (arg === "--dry-run") {
+        options.dryRun = true;
+        return true;
+    }
+    if (arg === "--json") {
+        options.json = true;
+        return true;
+    }
+    if (arg === "--force") {
+        options.force = true;
+        return true;
+    }
+    if (arg === "--stdio") {
+        options.stdio = true;
+        return true;
+    }
+    return false;
+}
+export function parseInstallerArgs(args) {
+    const options = {
+        subcommand: "install",
+        scope: "global",
+        all: false,
+        yes: false,
+        dryRun: false,
+        json: false,
+        force: false,
+        stdio: false,
+    };
+    const subcommands = ["install", "doctor", "uninstall", "setup"];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (i === 0 && subcommands.includes(arg)) {
+            options.subcommand = arg === "setup" ? "install" : arg;
+            continue;
+        }
+        if (parseValuedFlag(arg, args[i + 1], options)) {
+            i++;
+        }
+        else {
+            parseBooleanFlag(arg, options);
+        }
+    }
+    return options;
+}
+//# sourceMappingURL=cli-parser.js.map

package/dist/installer/cli-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-parser.js","sourceRoot":"","sources":["../../src/installer/cli-parser.ts"],"names":[],"mappings":"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"}

package/dist/installer/cli.d.ts

@@ -0,0 +1,10 @@
+import { type InstallerOptions, type PlatformEnv } from "./types.js";
+export { parseInstallerArgs } from "./cli-parser.js";
+export interface CliIo {
+    writeStdout: (data: string) => void;
+    writeStderr: (data: string) => void;
+    cwd?: string;
+    env?: PlatformEnv;
+}
+export declare function runInstallerCli(options: InstallerOptions, ioOverrides?: Partial<CliIo>): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/installer/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/installer/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAyJD,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,EACzB,WAAW,GAAE,OAAO,CAAC,KAAK,CAAM,GAC/B,OAAO,CAAC,MAAM,CAAC,CAkFjB"}

package/dist/installer/cli.js

@@ -0,0 +1,208 @@
+import fs from "node:fs";
+import path from "node:path";
+import {} from "./types.js";
+import { ALL_TARGETS, getTargetById, resolveTargetEnvironment } from "./targets.js";
+import { detectAllTargets } from "./detector.js";
+import { patchContent, removeContent } from "./patchers/index.js";
+import { createBackup, atomicWrite } from "./backup.js";
+import { generateUnifiedDiff, colorizeDiff } from "./diff.js";
+export { parseInstallerArgs } from "./cli-parser.js";
+const defaultIo = {
+    writeStdout: (d) => process.stdout.write(d),
+    writeStderr: (d) => process.stderr.write(d),
+};
+function resolveSelectedTargets(options) {
+    if (options.targets && options.targets.length > 0) {
+        return options.targets
+            .map((id) => getTargetById(id))
+            .filter((t) => t !== undefined);
+    }
+    if (options.category === "cli") {
+        return ALL_TARGETS.filter((t) => t.category === "cli");
+    }
+    if (options.category === "ides") {
+        return ALL_TARGETS.filter((t) => t.category === "ide");
+    }
+    return [...ALL_TARGETS];
+}
+function buildPatcherEnv(target, env) {
+    if (target.needsMacGuiEnvPatch && env.platform === "darwin") {
+        const nodeDir = path.dirname(env.execPath);
+        const defaults = ["/opt/homebrew/bin", "/usr/local/bin", "/usr/bin", "/bin", "/usr/sbin", "/sbin"];
+        return { PATH: Array.from(new Set([nodeDir, ...defaults])).join(":") };
+    }
+    return undefined;
+}
+async function handleDryRun(target, paths, patched, raw, io) {
+    const diff = generateUnifiedDiff(raw, patched, path.basename(paths.configPath));
+    if (!io.writeStdout || io === defaultIo) {
+        io.writeStderr(`\n[dry-run] Proposed changes for ${target.displayName} (${paths.configPath}):\n`);
+        io.writeStderr(colorizeDiff(diff));
+    }
+    return {
+        targetId: target.id,
+        displayName: target.displayName,
+        category: target.category,
+        format: target.format,
+        targetPath: paths.configPath,
+        action: "CONFIGURED",
+        message: "Dry-run preview generated",
+        diff,
+    };
+}
+async function executeInstallTarget(target, options, env, io) {
+    const paths = target.resolvePaths(options.scope, env);
+    let raw = "";
+    if (fs.existsSync(paths.configPath)) {
+        raw = fs.readFileSync(paths.configPath, "utf8");
+    }
+    const patcherEnv = buildPatcherEnv(target, env);
+    const patched = patchContent(raw, {
+        targetId: target.id,
+        patcherType: target.patcherType,
+        format: target.format,
+        env: patcherEnv,
+    });
+    if (options.dryRun) {
+        return handleDryRun(target, paths, patched, raw, io);
+    }
+    let backupPath;
+    if (fs.existsSync(paths.configPath)) {
+        const bak = await createBackup(paths.configPath);
+        if (bak)
+            backupPath = bak;
+    }
+    await atomicWrite(paths.configPath, patched);
+    return {
+        targetId: target.id,
+        displayName: target.displayName,
+        category: target.category,
+        format: target.format,
+        targetPath: paths.configPath,
+        backupPath,
+        action: "CONFIGURED",
+        message: `Configured ${target.displayName}`,
+    };
+}
+async function executeUninstallTarget(target, options, env) {
+    const paths = target.resolvePaths(options.scope, env);
+    if (!fs.existsSync(paths.configPath)) {
+        return {
+            targetId: target.id,
+            displayName: target.displayName,
+            category: target.category,
+            format: target.format,
+            targetPath: paths.configPath,
+            action: "SKIPPED",
+            message: "Config file does not exist",
+        };
+    }
+    const raw = fs.readFileSync(paths.configPath, "utf8");
+    const uninstalled = removeContent(raw, {
+        targetId: target.id,
+        patcherType: target.patcherType,
+        format: target.format,
+    });
+    let backupPath;
+    const bak = await createBackup(paths.configPath);
+    if (bak)
+        backupPath = bak;
+    await atomicWrite(paths.configPath, uninstalled);
+    return {
+        targetId: target.id,
+        displayName: target.displayName,
+        category: target.category,
+        format: target.format,
+        targetPath: paths.configPath,
+        backupPath,
+        action: "REMOVED",
+        message: `Removed Sirius configuration from ${target.displayName}`,
+    };
+}
+function emitReport(report, options, io) {
+    if (options.json) {
+        io.writeStdout(JSON.stringify(report, null, 2) + "\n");
+    }
+    else {
+        io.writeStderr(`\n[sirius] Completed: ${report.summary.configured} configured, ${report.summary.skipped} skipped, ${report.summary.failed} failed.\n`);
+    }
+}
+export async function runInstallerCli(options, ioOverrides = {}) {
+    const io = { ...defaultIo, ...ioOverrides };
+    const env = io.env ?? {
+        ...resolveTargetEnvironment(),
+        ...(io.cwd ? { cwd: io.cwd } : {}),
+    };
+    if (options.subcommand === "doctor") {
+        const detected = await detectAllTargets(options.scope, env);
+        const results = detected.map((d) => ({
+            targetId: d.target.id,
+            displayName: d.target.displayName,
+            category: d.target.category,
+            format: d.target.format,
+            targetPath: d.configPath,
+            action: d.state === "ALREADY_CONFIGURED" ? "ALREADY_CONFIGURED" : "SKIPPED",
+            message: `State: ${d.state}`,
+        }));
+        const report = {
+            version: "1.4.1",
+            timestamp: new Date().toISOString(),
+            platform: env.platform,
+            arch: process.arch,
+            dryRun: false,
+            scope: options.scope,
+            summary: {
+                totalScanned: detected.length,
+                configured: detected.filter((d) => d.state === "ALREADY_CONFIGURED").length,
+                skipped: detected.filter((d) => d.state !== "ALREADY_CONFIGURED").length,
+                failed: 0,
+            },
+            targets: results,
+        };
+        emitReport(report, options, io);
+        return 0;
+    }
+    const selected = resolveSelectedTargets(options);
+    const results = [];
+    for (const target of selected) {
+        try {
+            if (options.subcommand === "uninstall") {
+                results.push(await executeUninstallTarget(target, options, env));
+            }
+            else {
+                results.push(await executeInstallTarget(target, options, env, io));
+            }
+        }
+        catch (err) {
+            results.push({
+                targetId: target.id,
+                displayName: target.displayName,
+                category: target.category,
+                format: target.format,
+                targetPath: target.resolvePaths(options.scope, env).configPath,
+                action: "FAILED",
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    const failedCount = results.filter((r) => r.action === "FAILED").length;
+    const configuredCount = results.filter((r) => r.action === "CONFIGURED" || r.action === "REMOVED").length;
+    const report = {
+        version: "1.4.1",
+        timestamp: new Date().toISOString(),
+        platform: env.platform,
+        arch: process.arch,
+        dryRun: options.dryRun,
+        scope: options.scope,
+        summary: {
+            totalScanned: selected.length,
+            configured: configuredCount,
+            skipped: selected.length - configuredCount - failedCount,
+            failed: failedCount,
+        },
+        targets: results,
+    };
+    emitReport(report, options, io);
+    return failedCount > 0 ? 1 : 0;
+}
+//# sourceMappingURL=cli.js.map