anantham-v2 2.0.0-alpha.1

package/dist/persistence/sqlite-engine.d.ts

@@ -0,0 +1,76 @@
+import { DatabaseSync } from "node:sqlite";
+export interface DatabaseConfig {
+    /**
+     * Path to the SQLite database file, or ':memory:' for an in-memory database.
+     */
+    path: string;
+    /**
+     * Synchronous mode: 'FULL' (default, maximum durability RPO 0), 'NORMAL', 'OFF'.
+     */
+    synchronous?: "FULL" | "NORMAL" | "OFF";
+    /**
+     * Busy timeout in milliseconds. Defaults to 5000ms.
+     */
+    busyTimeoutMs?: number;
+    /**
+     * Read-only mode. Defaults to false.
+     */
+    readOnly?: boolean;
+}
+export interface IntegrityCheckResult {
+    ok: boolean;
+    messages: string[];
+}
+/**
+ * Anantham V2 Authoritative SQLite Engine.
+ * PRD Part 1 Section 43-45 (PRD-DUR-001) / Tech Stack Section 4.
+ */
+export declare class SqliteEngine {
+    private db;
+    private readonly config;
+    constructor(config: DatabaseConfig);
+    /**
+     * Initializes and opens the SQLite database with strict durability pragmas.
+     */
+    open(): void;
+    /**
+     * Returns the underlying native DatabaseSync instance.
+     */
+    get raw(): DatabaseSync;
+    /**
+     * Checks whether the database connection is currently open.
+     */
+    isOpen(): boolean;
+    /**
+     * Closes the database connection.
+     */
+    close(): void;
+    private transactionDepth;
+    /**
+     * Executes a callback within a transactional boundary.
+     * If the callback throws, the transaction is automatically rolled back.
+     * If the callback succeeds, the transaction is committed.
+     * Supports nested transaction invocations cleanly.
+     */
+    transaction<T>(fn: () => T): T;
+    /**
+     * Executes PRAGMA integrity_check to verify database health.
+     */
+    integrityCheck(): IntegrityCheckResult;
+    /**
+     * Executes PRAGMA foreign_key_check to verify referential integrity.
+     */
+    foreignKeyCheck(): {
+        ok: boolean;
+        violations: Array<Record<string, unknown>>;
+    };
+    /**
+     * Creates an online hot backup using SQLite VACUUM INTO.
+     */
+    backup(destinationPath: string): void;
+    /**
+     * Executes explicit WAL checkpoint.
+     */
+    checkpoint(mode?: "PASSIVE" | "FULL" | "RESTART" | "TRUNCATE"): void;
+}
+//# sourceMappingURL=sqlite-engine.d.ts.map

package/dist/persistence/sqlite-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-engine.d.ts","sourceRoot":"","sources":["../../src/persistence/sqlite-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACxC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAA6B;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,MAAM,EAAE,cAAc;IASlC;;OAEG;IACI,IAAI,IAAI,IAAI;IAyBnB;;OAEG;IACH,IAAW,GAAG,IAAI,YAAY,CAK7B;IAED;;OAEG;IACI,MAAM,IAAI,OAAO;IAIxB;;OAEG;IACI,KAAK,IAAI,IAAI;IAOpB,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;;;OAKG;IACI,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IA8BrC;;OAEG;IACI,cAAc,IAAI,oBAAoB;IAa7C;;OAEG;IACI,eAAe,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE;IAUrF;;OAEG;IACI,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAQ5C;;OAEG;IACI,UAAU,CAAC,IAAI,GAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAsB,GAAG,IAAI;CAMvF"}

package/dist/persistence/sqlite-engine.js

@@ -0,0 +1,149 @@
+import { DatabaseSync } from "node:sqlite";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Anantham V2 Authoritative SQLite Engine.
+ * PRD Part 1 Section 43-45 (PRD-DUR-001) / Tech Stack Section 4.
+ */
+export class SqliteEngine {
+    db = null;
+    config;
+    constructor(config) {
+        this.config = {
+            path: config.path,
+            synchronous: config.synchronous ?? "FULL",
+            busyTimeoutMs: config.busyTimeoutMs ?? 5000,
+            readOnly: config.readOnly ?? false,
+        };
+    }
+    /**
+     * Initializes and opens the SQLite database with strict durability pragmas.
+     */
+    open() {
+        if (this.db) {
+            return;
+        }
+        if (this.config.path !== ":memory:") {
+            const dir = dirname(this.config.path);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+        }
+        this.db = new DatabaseSync(this.config.path, {
+            readOnly: this.config.readOnly,
+        });
+        // Apply strict Anantham durability and relational pragmas
+        if (this.config.path !== ":memory:") {
+            this.db.exec("PRAGMA journal_mode = WAL;");
+        }
+        this.db.exec(`PRAGMA synchronous = ${this.config.synchronous};`);
+        this.db.exec("PRAGMA foreign_keys = ON;");
+        this.db.exec(`PRAGMA busy_timeout = ${this.config.busyTimeoutMs};`);
+    }
+    /**
+     * Returns the underlying native DatabaseSync instance.
+     */
+    get raw() {
+        if (!this.db) {
+            throw new Error("SqliteEngine is not opened. Call open() first.");
+        }
+        return this.db;
+    }
+    /**
+     * Checks whether the database connection is currently open.
+     */
+    isOpen() {
+        return this.db !== null;
+    }
+    /**
+     * Closes the database connection.
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    transactionDepth = 0;
+    /**
+     * Executes a callback within a transactional boundary.
+     * If the callback throws, the transaction is automatically rolled back.
+     * If the callback succeeds, the transaction is committed.
+     * Supports nested transaction invocations cleanly.
+     */
+    transaction(fn) {
+        if (!this.db) {
+            throw new Error("Cannot run transaction on closed database.");
+        }
+        const isOuter = this.transactionDepth === 0;
+        this.transactionDepth++;
+        if (isOuter) {
+            this.db.exec("BEGIN IMMEDIATE TRANSACTION;");
+        }
+        try {
+            const result = fn();
+            if (isOuter) {
+                this.db.exec("COMMIT;");
+            }
+            return result;
+        }
+        catch (error) {
+            if (isOuter) {
+                try {
+                    this.db.exec("ROLLBACK;");
+                }
+                catch {
+                    // Rollback error secondary to original throw
+                }
+            }
+            throw error;
+        }
+        finally {
+            this.transactionDepth--;
+        }
+    }
+    /**
+     * Executes PRAGMA integrity_check to verify database health.
+     */
+    integrityCheck() {
+        if (!this.db) {
+            throw new Error("Cannot run integrity check on closed database.");
+        }
+        const stmt = this.db.prepare("PRAGMA integrity_check;");
+        const rows = stmt.all();
+        const messages = rows.map((r) => String(Object.values(r)[0] ?? ""));
+        const ok = messages.length === 1 && messages[0] === "ok";
+        return { ok, messages };
+    }
+    /**
+     * Executes PRAGMA foreign_key_check to verify referential integrity.
+     */
+    foreignKeyCheck() {
+        if (!this.db) {
+            throw new Error("Cannot run foreign key check on closed database.");
+        }
+        const stmt = this.db.prepare("PRAGMA foreign_key_check;");
+        const violations = stmt.all();
+        return { ok: violations.length === 0, violations };
+    }
+    /**
+     * Creates an online hot backup using SQLite VACUUM INTO.
+     */
+    backup(destinationPath) {
+        if (!this.db) {
+            throw new Error("Cannot run backup on closed database.");
+        }
+        const escaped = destinationPath.replace(/'/g, "''");
+        this.db.exec(`VACUUM INTO '${escaped}';`);
+    }
+    /**
+     * Executes explicit WAL checkpoint.
+     */
+    checkpoint(mode = "PASSIVE") {
+        if (!this.db) {
+            throw new Error("Cannot checkpoint closed database.");
+        }
+        this.db.exec(`PRAGMA wal_checkpoint(${mode});`);
+    }
+}
+//# sourceMappingURL=sqlite-engine.js.map

package/dist/persistence/sqlite-engine.js.map

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

package/dist/plugins/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Anantham V2 — Plugins Subsystem
+ *
+ * Export all plugin managers, installers, compatibility checkers, dependency resolvers,
+ * permission reviewers, trust managers, state managers, and diagnostics.
+ */
+export * from "./plugin-compatibility.js";
+export * from "./plugin-dependency.js";
+export * from "./plugin-package.js";
+export * from "./plugin-permissions.js";
+export * from "./plugin-trust.js";
+export * from "./plugin-installer.js";
+export * from "./plugin-manager.js";
+export * from "./plugin-registry.js";
+export * from "./plugin-state.js";
+export * from "./plugin-doctor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,17 @@
+/**
+ * Anantham V2 — Plugins Subsystem
+ *
+ * Export all plugin managers, installers, compatibility checkers, dependency resolvers,
+ * permission reviewers, trust managers, state managers, and diagnostics.
+ */
+export * from "./plugin-compatibility.js";
+export * from "./plugin-dependency.js";
+export * from "./plugin-package.js";
+export * from "./plugin-permissions.js";
+export * from "./plugin-trust.js";
+export * from "./plugin-installer.js";
+export * from "./plugin-manager.js";
+export * from "./plugin-registry.js";
+export * from "./plugin-state.js";
+export * from "./plugin-doctor.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/plugins/plugin-compatibility.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Anantham V2 — Plugin Compatibility Checker
+ *
+ * Evaluates OS platform compatibility, Node version ranges, Anantham runtime version,
+ * and required system capabilities.
+ */
+import { type PluginCompatibility } from "../domain/plugin.js";
+export interface CompatibilityCheckResult {
+    isCompatible: boolean;
+    reasons: string[];
+}
+export declare class PluginCompatibilityChecker {
+    private readonly currentOs;
+    private readonly currentNodeVersion;
+    private readonly currentRuntimeVersion;
+    constructor(options?: {
+        os?: string;
+        nodeVersion?: string;
+        runtimeVersion?: string;
+    });
+    /**
+     * Evaluates whether a plugin's compatibility constraints are satisfied.
+     */
+    checkCompatibility(compatibility?: Partial<PluginCompatibility>, availableCapabilities?: string[]): CompatibilityCheckResult;
+}
+//# sourceMappingURL=plugin-compatibility.d.ts.map

package/dist/plugins/plugin-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-compatibility.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-compatibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAEnC,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IAMpF;;OAEG;IACI,kBAAkB,CACvB,aAAa,GAAE,OAAO,CAAC,mBAAmB,CAAM,EAChD,qBAAqB,GAAE,MAAM,EAAO,GACnC,wBAAwB;CAuD5B"}

package/dist/plugins/plugin-compatibility.js

@@ -0,0 +1,64 @@
+/**
+ * Anantham V2 — Plugin Compatibility Checker
+ *
+ * Evaluates OS platform compatibility, Node version ranges, Anantham runtime version,
+ * and required system capabilities.
+ */
+export class PluginCompatibilityChecker {
+    currentOs;
+    currentNodeVersion;
+    currentRuntimeVersion;
+    constructor(options) {
+        this.currentOs = options?.os || process.platform;
+        this.currentNodeVersion = options?.nodeVersion || process.version;
+        this.currentRuntimeVersion = options?.runtimeVersion || "2.0.0-alpha.1";
+    }
+    /**
+     * Evaluates whether a plugin's compatibility constraints are satisfied.
+     */
+    checkCompatibility(compatibility = {}, availableCapabilities = []) {
+        const reasons = [];
+        // 1. OS Compatibility Check
+        if (compatibility.os && compatibility.os.length > 0) {
+            if (!compatibility.os.includes(this.currentOs)) {
+                reasons.push(`Incompatible OS: Plugin requires [${compatibility.os.join(", ")}], current platform is "${this.currentOs}".`);
+            }
+        }
+        // 2. Node Version Check (simple >= constraint check)
+        if (compatibility.node) {
+            const minNodeMatch = compatibility.node.match(/>=\s*(\d+)/);
+            if (minNodeMatch && minNodeMatch[1]) {
+                const minMajor = parseInt(minNodeMatch[1], 10);
+                const currentMajorMatch = this.currentNodeVersion.match(/v?(\d+)/);
+                const currentMajor = currentMajorMatch && currentMajorMatch[1] ? parseInt(currentMajorMatch[1], 10) : 0;
+                if (currentMajor < minMajor) {
+                    reasons.push(`Incompatible Node.js version: Plugin requires "${compatibility.node}", current version is "${this.currentNodeVersion}".`);
+                }
+            }
+        }
+        // 3. Runtime Version Check
+        if (compatibility.runtime) {
+            const minRuntimeMatch = compatibility.runtime.match(/>=\s*(\d+)/);
+            if (minRuntimeMatch && minRuntimeMatch[1]) {
+                const minMajor = parseInt(minRuntimeMatch[1], 10);
+                const currentMajor = parseInt(this.currentRuntimeVersion.split(".")[0] || "2", 10);
+                if (currentMajor < minMajor) {
+                    reasons.push(`Incompatible Anantham runtime: Plugin requires "${compatibility.runtime}", current runtime is "${this.currentRuntimeVersion}".`);
+                }
+            }
+        }
+        // 4. Required Capabilities Check
+        if (compatibility.capabilities && compatibility.capabilities.length > 0) {
+            for (const cap of compatibility.capabilities) {
+                if (!availableCapabilities.includes(cap)) {
+                    reasons.push(`Missing required capability: "${cap}".`);
+                }
+            }
+        }
+        return {
+            isCompatible: reasons.length === 0,
+            reasons,
+        };
+    }
+}
+//# sourceMappingURL=plugin-compatibility.js.map

package/dist/plugins/plugin-compatibility.js.map

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

package/dist/plugins/plugin-dependency.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Anantham V2 — Plugin Dependency Resolver
+ *
+ * Resolves multi-plugin dependency graphs, validates version constraints,
+ * and detects cyclic or missing dependencies.
+ */
+import { type PluginManifest, type PluginDependency } from "../domain/plugin.js";
+export interface DependencyResolutionResult {
+    isResolved: boolean;
+    resolutionOrder: string[];
+    missingDependencies: Array<{
+        pluginId: string;
+        dependency: PluginDependency;
+    }>;
+    incompatibleVersions: Array<{
+        pluginId: string;
+        required: string;
+        available: string;
+    }>;
+    cyclicDependencies: string[][];
+    errors: string[];
+}
+export declare class PluginDependencyResolver {
+    /**
+     * Resolves dependency graph for a collection of plugin manifests.
+     */
+    resolve(targetManifests: PluginManifest[], installedManifests?: PluginManifest[]): DependencyResolutionResult;
+    private matchesVersion;
+}
+//# sourceMappingURL=plugin-dependency.d.ts.map

package/dist/plugins/plugin-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-dependency.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-dependency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAC;IAC/E,oBAAoB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,kBAAkB,EAAE,MAAM,EAAE,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,wBAAwB;IACnC;;OAEG;IACI,OAAO,CACZ,eAAe,EAAE,cAAc,EAAE,EACjC,kBAAkB,GAAE,cAAc,EAAO,GACxC,0BAA0B;IAyF7B,OAAO,CAAC,cAAc;CA4BvB"}

package/dist/plugins/plugin-dependency.js

@@ -0,0 +1,119 @@
+/**
+ * Anantham V2 — Plugin Dependency Resolver
+ *
+ * Resolves multi-plugin dependency graphs, validates version constraints,
+ * and detects cyclic or missing dependencies.
+ */
+export class PluginDependencyResolver {
+    /**
+     * Resolves dependency graph for a collection of plugin manifests.
+     */
+    resolve(targetManifests, installedManifests = []) {
+        const allManifestsMap = new Map();
+        for (const m of installedManifests) {
+            allManifestsMap.set(m.id, m);
+        }
+        for (const m of targetManifests) {
+            allManifestsMap.set(m.id, m);
+        }
+        const missingDependencies = [];
+        const incompatibleVersions = [];
+        const cyclicDependencies = [];
+        // 1. Check for missing and incompatible dependencies
+        for (const manifest of allManifestsMap.values()) {
+            for (const dep of manifest.dependencies || []) {
+                const target = allManifestsMap.get(dep.id);
+                if (!target) {
+                    if (!dep.optional) {
+                        missingDependencies.push({ pluginId: manifest.id, dependency: dep });
+                    }
+                    continue;
+                }
+                // SemVer matching
+                if (!this.matchesVersion(target.version, dep.version)) {
+                    incompatibleVersions.push({
+                        pluginId: manifest.id,
+                        required: `${dep.id}@${dep.version}`,
+                        available: target.version,
+                    });
+                }
+            }
+        }
+        // 2. Cycle Detection & Topological Sort
+        const visited = new Map();
+        const resolutionOrder = [];
+        const dfs = (pluginId, path) => {
+            if (visited.get(pluginId) === "visiting") {
+                const cycleStartIndex = path.indexOf(pluginId);
+                cyclicDependencies.push([...path.slice(cycleStartIndex), pluginId]);
+                return;
+            }
+            if (visited.get(pluginId) === "visited") {
+                return;
+            }
+            visited.set(pluginId, "visiting");
+            const current = allManifestsMap.get(pluginId);
+            if (current) {
+                for (const dep of current.dependencies || []) {
+                    if (allManifestsMap.has(dep.id)) {
+                        dfs(dep.id, [...path, pluginId]);
+                    }
+                }
+            }
+            visited.set(pluginId, "visited");
+            resolutionOrder.push(pluginId);
+        };
+        for (const id of allManifestsMap.keys()) {
+            if (!visited.has(id)) {
+                dfs(id, []);
+            }
+        }
+        const compiledErrors = [];
+        for (const missing of missingDependencies) {
+            compiledErrors.push(`Plugin "${missing.pluginId}" missing required dependency "${missing.dependency.id}".`);
+        }
+        for (const incomp of incompatibleVersions) {
+            compiledErrors.push(`Plugin "${incomp.pluginId}" incompatible version: requires "${incomp.required}", available is "${incomp.available}".`);
+        }
+        for (const cycle of cyclicDependencies) {
+            compiledErrors.push(`Cyclic dependency detected: ${cycle.join(" -> ")}.`);
+        }
+        return {
+            isResolved: compiledErrors.length === 0,
+            resolutionOrder,
+            missingDependencies,
+            incompatibleVersions,
+            cyclicDependencies,
+            errors: compiledErrors,
+        };
+    }
+    matchesVersion(actual, required) {
+        if (required === "*" || required === actual)
+            return true;
+        const caretMatch = required.match(/^\^(\d+)\.(\d+)\.(\d+)/);
+        if (caretMatch && caretMatch[1]) {
+            const reqMajor = caretMatch[1];
+            const actualMajor = actual.split(".")[0];
+            return reqMajor === actualMajor;
+        }
+        const gteMatch = required.match(/^>=\s*(\d+)\.(\d+)\.(\d+)/);
+        if (gteMatch && gteMatch[1] && gteMatch[2] && gteMatch[3]) {
+            const reqMajor = parseInt(gteMatch[1], 10);
+            const reqMinor = parseInt(gteMatch[2], 10);
+            const reqPatch = parseInt(gteMatch[3], 10);
+            const [actMajor = 0, actMinor = 0, actPatch = 0] = actual.split(".").map((n) => parseInt(n, 10));
+            if (actMajor > reqMajor)
+                return true;
+            if (actMajor === reqMajor) {
+                if (actMinor > reqMinor)
+                    return true;
+                if (actMinor === reqMinor) {
+                    return actPatch >= reqPatch;
+                }
+            }
+            return false;
+        }
+        return actual === required;
+    }
+}
+//# sourceMappingURL=plugin-dependency.js.map

package/dist/plugins/plugin-dependency.js.map

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

package/dist/plugins/plugin-doctor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Anantham V2 — Plugin Doctor Diagnostics
+ *
+ * Implements comprehensive system diagnostics for plugins (/plugins doctor).
+ */
+import { PluginManager } from "./plugin-manager.js";
+export interface PluginDiagnosticReport {
+    pluginId: string;
+    name: string;
+    version: string;
+    trustState: string;
+    lifecycleState: string;
+    healthState: string;
+    isHealthy: boolean;
+    issues: string[];
+}
+export declare class PluginDoctor {
+    private readonly manager;
+    constructor(manager: PluginManager);
+    diagnosePlugin(pluginId: string): PluginDiagnosticReport;
+    diagnoseAll(): PluginDiagnosticReport[];
+}
+//# sourceMappingURL=plugin-doctor.d.ts.map

package/dist/plugins/plugin-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-doctor.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,EAAE,aAAa;IAI3B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB;IAyCxD,WAAW,IAAI,sBAAsB,EAAE;CAI/C"}

package/dist/plugins/plugin-doctor.js

@@ -0,0 +1,51 @@
+/**
+ * Anantham V2 — Plugin Doctor Diagnostics
+ *
+ * Implements comprehensive system diagnostics for plugins (/plugins doctor).
+ */
+export class PluginDoctor {
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    diagnosePlugin(pluginId) {
+        const plugin = this.manager.getPlugin(pluginId);
+        if (!plugin) {
+            return {
+                pluginId,
+                name: "Unknown",
+                version: "0.0.0",
+                trustState: "unknown",
+                lifecycleState: "failed",
+                healthState: "failed",
+                isHealthy: false,
+                issues: [`Plugin "${pluginId}" is not registered.`],
+            };
+        }
+        const issues = [];
+        if (plugin.trustState === "blocked") {
+            issues.push("Plugin is marked as BLOCKED.");
+        }
+        if (plugin.healthState === "unhealthy" || plugin.healthState === "failed") {
+            issues.push(`Plugin health is currently ${plugin.healthState}.`);
+        }
+        if (plugin.lifecycleState === "failed") {
+            issues.push("Plugin lifecycle state is FAILED.");
+        }
+        return {
+            pluginId: plugin.manifest.id,
+            name: plugin.manifest.name,
+            version: plugin.manifest.version,
+            trustState: plugin.trustState,
+            lifecycleState: plugin.lifecycleState,
+            healthState: plugin.healthState,
+            isHealthy: issues.length === 0,
+            issues,
+        };
+    }
+    diagnoseAll() {
+        const all = this.manager.listPlugins();
+        return all.map((p) => this.diagnosePlugin(p.manifest.id));
+    }
+}
+//# sourceMappingURL=plugin-doctor.js.map

package/dist/plugins/plugin-doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-doctor.js","sourceRoot":"","sources":["../../src/plugins/plugin-doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,MAAM,OAAO,YAAY;IACN,OAAO,CAAgB;IAExC,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,cAAc,CAAC,QAAgB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,QAAQ;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,OAAO;gBAChB,UAAU,EAAE,SAAS;gBACrB,cAAc,EAAE,QAAQ;gBACxB,WAAW,EAAE,QAAQ;gBACrB,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,CAAC,WAAW,QAAQ,sBAAsB,CAAC;aACpD,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC1E,MAAM,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;YAC5B,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YAC1B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;YAChC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC9B,MAAM;SACP,CAAC;IACJ,CAAC;IAEM,WAAW;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF"}