@mimir-labs/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SeaBassLab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @mimir-labs/core
+
+Core business logic and reusable services for the Mimir CLI.
+
+See extension guidance in [EXTENSIONS.md](./EXTENSIONS.md).

package/dist/implementation/adapters/agents-md/adapter.d.ts

@@ -0,0 +1,2 @@
+import type { AgentAdapter } from "../types";
+export declare const agentsMdAdapter: AgentAdapter;

package/dist/implementation/adapters/agents-md/adapter.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentsMdAdapter = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const managed_section_1 = require("../managed-section");
+exports.agentsMdAdapter = {
+    name: "agents-md",
+    async sync(context) {
+        const targetPath = node_path_1.default.join(context.cwd, "AGENTS.md");
+        const { changed, created } = await (0, managed_section_1.upsertManagedSection)(targetPath, [
+            "## APS Context",
+            "",
+            "Generated AI package knowledge:",
+            "",
+            "Read:",
+            "- .agents/aps/index.md"
+        ]);
+        return {
+            adapter: "agents-md",
+            target: targetPath,
+            changed,
+            created,
+            message: created
+                ? "AGENTS.md created"
+                : changed
+                    ? "AGENTS.md APS section updated"
+                    : "AGENTS.md already synchronized",
+            warnings: []
+        };
+    }
+};
+//# sourceMappingURL=adapter.js.map

package/dist/implementation/adapters/agents-md/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/implementation/adapters/agents-md/adapter.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAC7B,wDAA0D;AAG7C,QAAA,eAAe,GAAiB;IAC3C,IAAI,EAAE,WAAW;IACjB,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACvD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,sCAAoB,EAAC,UAAU,EAAE;YAClE,gBAAgB;YAChB,EAAE;YACF,iCAAiC;YACjC,EAAE;YACF,OAAO;YACP,wBAAwB;SACzB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,UAAU;YAClB,OAAO;YACP,OAAO;YACP,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,mBAAmB;gBACrB,CAAC,CAAC,OAAO;oBACP,CAAC,CAAC,+BAA+B;oBACjC,CAAC,CAAC,gCAAgC;YACtC,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/implementation/adapters/copilot/adapter.d.ts

@@ -0,0 +1,2 @@
+import type { AgentAdapter } from "../types";
+export declare const copilotAdapter: AgentAdapter;

package/dist/implementation/adapters/copilot/adapter.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copilotAdapter = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const managed_section_1 = require("../managed-section");
+exports.copilotAdapter = {
+    name: "copilot",
+    async sync(context) {
+        const targetPath = node_path_1.default.join(context.cwd, ".github", "copilot-instructions.md");
+        const { changed, created } = await (0, managed_section_1.upsertManagedSection)(targetPath, [
+            "## APS Context",
+            "",
+            "Use generated APS knowledge as reference:",
+            "",
+            "- .agents/aps/index.md"
+        ]);
+        return {
+            adapter: "copilot",
+            target: targetPath,
+            changed,
+            created,
+            message: created
+                ? "Copilot instructions created"
+                : changed
+                    ? "Copilot instructions APS section updated"
+                    : "Copilot instructions already synchronized",
+            warnings: []
+        };
+    }
+};
+//# sourceMappingURL=adapter.js.map

package/dist/implementation/adapters/copilot/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/implementation/adapters/copilot/adapter.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAC7B,wDAA0D;AAG7C,QAAA,cAAc,GAAiB;IAC1C,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;QAChF,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,sCAAoB,EAAC,UAAU,EAAE;YAClE,gBAAgB;YAChB,EAAE;YACF,2CAA2C;YAC3C,EAAE;YACF,wBAAwB;SACzB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,UAAU;YAClB,OAAO;YACP,OAAO;YACP,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,8BAA8B;gBAChC,CAAC,CAAC,OAAO;oBACP,CAAC,CAAC,0CAA0C;oBAC5C,CAAC,CAAC,2CAA2C;YACjD,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/implementation/adapters/cursor/adapter.d.ts

@@ -0,0 +1,2 @@
+import type { AgentAdapter } from "../types";
+export declare const cursorAdapter: AgentAdapter;

package/dist/implementation/adapters/cursor/adapter.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cursorAdapter = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const managed_section_1 = require("../managed-section");
+exports.cursorAdapter = {
+    name: "cursor",
+    async sync(context) {
+        const targetPath = node_path_1.default.join(context.cwd, ".cursor", "rules", "aps.mdc");
+        const { changed, created } = await (0, managed_section_1.upsertManagedSection)(targetPath, [
+            "# APS Context",
+            "",
+            "Read generated APS knowledge:",
+            "- .agents/aps/index.md"
+        ]);
+        return {
+            adapter: "cursor",
+            target: targetPath,
+            changed,
+            created,
+            message: created
+                ? "Cursor APS rule created"
+                : changed
+                    ? "Cursor APS rule updated"
+                    : "Cursor APS rule already synchronized",
+            warnings: []
+        };
+    }
+};
+//# sourceMappingURL=adapter.js.map

package/dist/implementation/adapters/cursor/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../src/implementation/adapters/cursor/adapter.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAC7B,wDAA0D;AAG7C,QAAA,aAAa,GAAiB;IACzC,IAAI,EAAE,QAAQ;IACd,KAAK,CAAC,IAAI,CAAC,OAAO;QAChB,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACzE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,sCAAoB,EAAC,UAAU,EAAE;YAClE,eAAe;YACf,EAAE;YACF,+BAA+B;YAC/B,wBAAwB;SACzB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,UAAU;YAClB,OAAO;YACP,OAAO;YACP,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,yBAAyB;gBAC3B,CAAC,CAAC,OAAO;oBACP,CAAC,CAAC,yBAAyB;oBAC3B,CAAC,CAAC,sCAAsC;YAC5C,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/implementation/adapters/index.d.ts

@@ -0,0 +1,5 @@
+import type { AgentAdapter } from "./types";
+export type { AgentAdapter, AgentContext, SyncResult } from "./types";
+export declare function registerAdapter(adapter: AgentAdapter, aliases?: string[]): void;
+export declare function getAdapter(name: string): AgentAdapter | undefined;
+export declare function getConfiguredAdapters(adapterConfig: unknown): AgentAdapter[];

package/dist/implementation/adapters/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAdapter = registerAdapter;
+exports.getAdapter = getAdapter;
+exports.getConfiguredAdapters = getConfiguredAdapters;
+const adapter_1 = require("./agents-md/adapter");
+const adapter_2 = require("./copilot/adapter");
+const adapter_3 = require("./cursor/adapter");
+const registry_1 = require("./registry");
+const adapterRegistry = new registry_1.AdapterRegistry();
+adapterRegistry.register(adapter_1.agentsMdAdapter, ["agents"]);
+adapterRegistry.register(adapter_2.copilotAdapter);
+adapterRegistry.register(adapter_3.cursorAdapter);
+function registerAdapter(adapter, aliases = []) {
+    adapterRegistry.register(adapter, aliases);
+}
+function getAdapter(name) {
+    return adapterRegistry.get(name);
+}
+function getConfiguredAdapters(adapterConfig) {
+    return adapterRegistry.resolve(adapterConfig);
+}
+//# sourceMappingURL=index.js.map

package/dist/implementation/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementation/adapters/index.ts"],"names":[],"mappings":";;AAcA,0CAEC;AAED,gCAEC;AAED,sDAEC;AAxBD,iDAAsD;AACtD,+CAAmD;AACnD,8CAAiD;AAEjD,yCAA6C;AAI7C,MAAM,eAAe,GAAG,IAAI,0BAAe,EAAE,CAAC;AAE9C,eAAe,CAAC,QAAQ,CAAC,yBAAe,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,eAAe,CAAC,QAAQ,CAAC,wBAAc,CAAC,CAAC;AACzC,eAAe,CAAC,QAAQ,CAAC,uBAAa,CAAC,CAAC;AAExC,SAAgB,eAAe,CAAC,OAAqB,EAAE,UAAoB,EAAE;IAC3E,eAAe,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,qBAAqB,CAAC,aAAsB;IAC1D,OAAO,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AAChD,CAAC"}

package/dist/implementation/adapters/managed-section.d.ts

@@ -0,0 +1,5 @@
+export declare function renderManagedBlock(contentLines: string[]): string;
+export declare function upsertManagedSection(filePath: string, contentLines: string[]): Promise<{
+    changed: boolean;
+    created: boolean;
+}>;

package/dist/implementation/adapters/managed-section.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderManagedBlock = renderManagedBlock;
+exports.upsertManagedSection = upsertManagedSection;
+const fs_1 = require("../io/fs");
+const APS_START_MARKER = "<!-- APS:START -->";
+const APS_END_MARKER = "<!-- APS:END -->";
+function renderManagedBlock(contentLines) {
+    return [APS_START_MARKER, "", ...contentLines, "", APS_END_MARKER].join("\n");
+}
+async function upsertManagedSection(filePath, contentLines) {
+    const managedSection = renderManagedBlock(contentLines);
+    if (!(await (0, fs_1.fileExists)(filePath))) {
+        await (0, fs_1.writeText)(filePath, `${managedSection}\n`);
+        return { changed: true, created: true };
+    }
+    const current = await (0, fs_1.readText)(filePath);
+    const startIndex = current.indexOf(APS_START_MARKER);
+    const endIndex = current.indexOf(APS_END_MARKER);
+    if (startIndex >= 0 && endIndex > startIndex) {
+        const before = current.slice(0, startIndex).trimEnd();
+        const after = current.slice(endIndex + APS_END_MARKER.length).trimStart();
+        const next = `${[before, managedSection, after].filter((part) => part.length > 0).join("\n\n")}\n`;
+        if (next === current) {
+            return { changed: false, created: false };
+        }
+        await (0, fs_1.writeText)(filePath, next);
+        return { changed: true, created: false };
+    }
+    const next = `${current.trimEnd()}\n\n${managedSection}\n`;
+    if (next === current) {
+        return { changed: false, created: false };
+    }
+    await (0, fs_1.writeText)(filePath, next);
+    return { changed: true, created: false };
+}
+//# sourceMappingURL=managed-section.js.map

package/dist/implementation/adapters/managed-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-section.js","sourceRoot":"","sources":["../../../src/implementation/adapters/managed-section.ts"],"names":[],"mappings":";;AAKA,gDAEC;AAED,oDAiCC;AA1CD,iCAA2D;AAE3D,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAC9C,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAE1C,SAAgB,kBAAkB,CAAC,YAAsB;IACvD,OAAO,CAAC,gBAAgB,EAAE,EAAE,EAAE,GAAG,YAAY,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChF,CAAC;AAEM,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,YAAsB;IAEtB,MAAM,cAAc,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAExD,IAAI,CAAC,CAAC,MAAM,IAAA,eAAU,EAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,IAAA,cAAS,EAAC,QAAQ,EAAE,GAAG,cAAc,IAAI,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjD,IAAI,UAAU,IAAI,CAAC,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnG,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,IAAA,cAAS,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,cAAc,IAAI,CAAC;IAC3D,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,IAAA,cAAS,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC"}

package/dist/implementation/adapters/registry.d.ts

@@ -0,0 +1,11 @@
+import type { AgentAdapter } from "./types";
+export declare class AdapterRegistry {
+    private readonly adaptersByName;
+    private readonly aliasToName;
+    private readonly defaultOrder;
+    register(adapter: AgentAdapter, aliases?: string[]): void;
+    get(name: string): AgentAdapter | undefined;
+    resolve(config: unknown): AgentAdapter[];
+    private resolveCanonical;
+    private normalize;
+}

package/dist/implementation/adapters/registry.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdapterRegistry = void 0;
+class AdapterRegistry {
+    adaptersByName = new Map();
+    aliasToName = new Map();
+    defaultOrder = [];
+    register(adapter, aliases = []) {
+        const canonicalName = this.normalize(adapter.name);
+        this.adaptersByName.set(canonicalName, adapter);
+        if (!this.defaultOrder.includes(canonicalName)) {
+            this.defaultOrder.push(canonicalName);
+        }
+        this.aliasToName.set(canonicalName, canonicalName);
+        for (const alias of aliases) {
+            this.aliasToName.set(this.normalize(alias), canonicalName);
+        }
+    }
+    get(name) {
+        const canonical = this.resolveCanonical(name);
+        return canonical ? this.adaptersByName.get(canonical) : undefined;
+    }
+    resolve(config) {
+        if (!Array.isArray(config)) {
+            return this.defaultOrder
+                .map((name) => this.adaptersByName.get(name))
+                .filter((adapter) => Boolean(adapter));
+        }
+        const selected = [...new Set(config)]
+            .filter((item) => typeof item === "string")
+            .map((item) => this.resolveCanonical(item))
+            .filter((name) => Boolean(name));
+        if (selected.length === 0) {
+            return this.defaultOrder
+                .map((name) => this.adaptersByName.get(name))
+                .filter((adapter) => Boolean(adapter));
+        }
+        return selected
+            .map((name) => this.adaptersByName.get(name))
+            .filter((adapter) => Boolean(adapter));
+    }
+    resolveCanonical(name) {
+        return this.aliasToName.get(this.normalize(name));
+    }
+    normalize(value) {
+        return value.trim().toLowerCase();
+    }
+}
+exports.AdapterRegistry = AdapterRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/implementation/adapters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/implementation/adapters/registry.ts"],"names":[],"mappings":";;;AAEA,MAAa,eAAe;IACT,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,YAAY,GAAa,EAAE,CAAC;IAE7C,QAAQ,CAAC,OAAqB,EAAE,UAAoB,EAAE;QACpD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAEhD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAED,OAAO,CAAC,MAAe;QACrB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,YAAY;iBACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;iBAC5C,MAAM,CAAC,CAAC,OAAO,EAA2B,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;aAClC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;aAC1D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;aAC1C,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,YAAY;iBACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;iBAC5C,MAAM,CAAC,CAAC,OAAO,EAA2B,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,QAAQ;aACZ,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aAC5C,MAAM,CAAC,CAAC,OAAO,EAA2B,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IAEO,gBAAgB,CAAC,IAAY;QACnC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;CACF;AAtDD,0CAsDC"}

package/dist/implementation/adapters/types.d.ts

@@ -0,0 +1,19 @@
+import type { DiscoveredProvider } from "../configuration/manifest-loader";
+export type AgentContext = {
+    cwd: string;
+    contextDir: string;
+    contextFiles: string[];
+    providers: DiscoveredProvider[];
+};
+export type SyncResult = {
+    adapter: string;
+    target: string;
+    changed: boolean;
+    created: boolean;
+    message: string;
+    warnings: string[];
+};
+export interface AgentAdapter {
+    name: string;
+    sync(context: AgentContext): Promise<SyncResult>;
+}

package/dist/implementation/adapters/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/implementation/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/implementation/adapters/types.ts"],"names":[],"mappings":""}

package/dist/implementation/configuration/manifest-loader.d.ts

@@ -0,0 +1,16 @@
+import { type ApsPackageConfig } from "./package-config";
+export type DiscoveredProvider = {
+    name: string;
+    packageRoot: string;
+    packageJsonPath: string;
+    aps: ApsPackageConfig;
+    configSource: "aps" | "ai";
+    manifestPath: string;
+    manifest: Record<string, unknown> | null;
+    resourceCounts: Array<{
+        key: string;
+        count: number;
+    }>;
+    warnings: string[];
+};
+export declare function loadApsProvider(packageName: string, fromDirectory: string): Promise<DiscoveredProvider | null>;

package/dist/implementation/configuration/manifest-loader.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadApsProvider = loadApsProvider;
+const node_path_1 = __importDefault(require("node:path"));
+const node_module_1 = require("node:module");
+const fs_1 = require("../io/fs");
+const json_1 = require("../io/json");
+const resource_summary_1 = require("../query/resource-summary");
+const package_config_1 = require("./package-config");
+const DEFAULT_MANIFEST_PATH = "./dist/aps/manifest.json";
+async function loadApsProvider(packageName, fromDirectory) {
+    const requireFromApp = (0, node_module_1.createRequire)(node_path_1.default.join(fromDirectory, "package.json"));
+    let packageJsonPath;
+    try {
+        packageJsonPath = requireFromApp.resolve(`${packageName}/package.json`);
+    }
+    catch {
+        return null;
+    }
+    const packageRoot = node_path_1.default.dirname(packageJsonPath);
+    const packageJson = await (0, fs_1.readJson)(packageJsonPath);
+    const configResolution = (0, package_config_1.resolveApsPackageConfig)(packageJson);
+    if (!configResolution.config || !configResolution.source) {
+        return null;
+    }
+    const aps = configResolution.config;
+    const manifestRelPath = typeof aps.manifest === "string" ? aps.manifest : DEFAULT_MANIFEST_PATH;
+    const manifestPath = node_path_1.default.resolve(packageRoot, manifestRelPath);
+    const warnings = [...configResolution.warnings];
+    let manifest = null;
+    if (await (0, fs_1.fileExists)(manifestPath)) {
+        try {
+            const parsed = await (0, fs_1.readJson)(manifestPath);
+            if ((0, json_1.isObject)(parsed)) {
+                manifest = parsed;
+            }
+            else {
+                warnings.push(`Manifest is not an object: ${manifestPath}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(message);
+        }
+    }
+    else {
+        warnings.push(`Manifest file missing: ${manifestPath}`);
+    }
+    return {
+        name: packageJson.name ?? packageName,
+        packageRoot,
+        packageJsonPath,
+        aps,
+        configSource: configResolution.source,
+        manifestPath,
+        manifest,
+        resourceCounts: manifest ? (0, resource_summary_1.extractResourceCounts)(manifest) : [],
+        warnings
+    };
+}
+//# sourceMappingURL=manifest-loader.js.map

package/dist/implementation/configuration/manifest-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.js","sourceRoot":"","sources":["../../../src/implementation/configuration/manifest-loader.ts"],"names":[],"mappings":";;;;;AA4BA,0CA0DC;AAtFD,0DAA6B;AAC7B,6CAA4C;AAC5C,iCAAgD;AAChD,qCAAsC;AACtC,gEAAkE;AAClE,qDAAkF;AAElF,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAqBlD,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,aAAqB;IAErB,MAAM,cAAc,GAAG,IAAA,2BAAa,EAAC,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAE/E,IAAI,eAAuB,CAAC;IAE5B,IAAI,CAAC;QACH,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,MAAM,IAAA,aAAQ,EAAc,eAAe,CAAC,CAAC;IAEjE,MAAM,gBAAgB,GAAG,IAAA,wCAAuB,EAAC,WAAW,CAAC,CAAC;IAE9D,IAAI,CAAC,gBAAgB,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACpC,MAAM,eAAe,GACnB,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAC1E,MAAM,YAAY,GAAG,mBAAI,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAa,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE1D,IAAI,QAAQ,GAAmC,IAAI,CAAC;IAEpD,IAAI,MAAM,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,aAAQ,EAAU,YAAY,CAAC,CAAC;YACrD,IAAI,IAAA,eAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;gBACrB,QAAQ,GAAG,MAAM,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,IAAI,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,WAAW;QACrC,WAAW;QACX,eAAe;QACf,GAAG;QACH,YAAY,EAAE,gBAAgB,CAAC,MAAM;QACrC,YAAY;QACZ,QAAQ;QACR,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAA,wCAAqB,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QAC/D,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/implementation/configuration/package-config.d.ts

@@ -0,0 +1,12 @@
+export type ApsPackageConfig = {
+    version?: number;
+    manifest?: string;
+    adapters?: unknown;
+    [key: string]: unknown;
+};
+export type ApsPackageConfigResolution = {
+    config: ApsPackageConfig | null;
+    source: "aps" | "ai" | null;
+    warnings: string[];
+};
+export declare function resolveApsPackageConfig(packageJson: Record<string, unknown>): ApsPackageConfigResolution;

package/dist/implementation/configuration/package-config.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApsPackageConfig = resolveApsPackageConfig;
+const json_1 = require("../io/json");
+function resolveApsPackageConfig(packageJson) {
+    const hasAps = (0, json_1.isObject)(packageJson.aps);
+    const hasAi = (0, json_1.isObject)(packageJson.ai);
+    const warnings = [];
+    if (hasAps && hasAi) {
+        warnings.push("Both 'aps' and legacy 'ai' configurations are present. Using 'aps'.");
+    }
+    if (hasAps) {
+        return {
+            config: packageJson.aps,
+            source: "aps",
+            warnings
+        };
+    }
+    if (hasAi) {
+        warnings.push("Legacy 'ai' configuration detected. Please migrate to 'aps'.");
+        return {
+            config: packageJson.ai,
+            source: "ai",
+            warnings
+        };
+    }
+    return {
+        config: null,
+        source: null,
+        warnings
+    };
+}
+//# sourceMappingURL=package-config.js.map

package/dist/implementation/configuration/package-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-config.js","sourceRoot":"","sources":["../../../src/implementation/configuration/package-config.ts"],"names":[],"mappings":";;AAeA,0DA+BC;AA9CD,qCAAsC;AAetC,SAAgB,uBAAuB,CAAC,WAAoC;IAC1E,MAAM,MAAM,GAAG,IAAA,eAAQ,EAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAA,eAAQ,EAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,WAAW,CAAC,GAAuB;YAC3C,MAAM,EAAE,KAAK;YACb,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO;YACL,MAAM,EAAE,WAAW,CAAC,EAAsB;YAC1C,MAAM,EAAE,IAAI;YACZ,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/implementation/dependency-discovery/discover-providers.d.ts

@@ -0,0 +1,6 @@
+import { type DiscoveredProvider } from "../configuration/manifest-loader";
+export type DiscoveryResult = {
+    providers: DiscoveredProvider[];
+    unresolvedDependencies: string[];
+};
+export declare function discoverProviders(cwd: string): Promise<DiscoveryResult>;

package/dist/implementation/dependency-discovery/discover-providers.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverProviders = discoverProviders;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_1 = require("../io/fs");
+const json_1 = require("../io/json");
+const manifest_loader_1 = require("../configuration/manifest-loader");
+function readDependencyNames(value) {
+    if (!(0, json_1.isObject)(value)) {
+        return [];
+    }
+    return Object.keys(value);
+}
+async function discoverProviders(cwd) {
+    const packageJsonPath = node_path_1.default.join(cwd, "package.json");
+    const packageJson = await (0, fs_1.readJson)(packageJsonPath);
+    const dependencies = readDependencyNames(packageJson.dependencies);
+    const devDependencies = readDependencyNames(packageJson.devDependencies);
+    const uniqueDependencies = [...new Set([...dependencies, ...devDependencies])].sort((a, b) => a.localeCompare(b));
+    const providers = [];
+    const unresolvedDependencies = [];
+    for (const dependency of uniqueDependencies) {
+        const provider = await (0, manifest_loader_1.loadApsProvider)(dependency, cwd);
+        if (!provider) {
+            unresolvedDependencies.push(dependency);
+            continue;
+        }
+        providers.push(provider);
+    }
+    providers.sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        providers,
+        unresolvedDependencies
+    };
+}
+//# sourceMappingURL=discover-providers.js.map

package/dist/implementation/dependency-discovery/discover-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-providers.js","sourceRoot":"","sources":["../../../src/implementation/dependency-discovery/discover-providers.ts"],"names":[],"mappings":";;;;;AAuBA,8CA+BC;AAtDD,0DAA6B;AAC7B,iCAAoC;AACpC,qCAAsC;AACtC,sEAA4F;AAY5F,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,IAAA,eAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAEM,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,MAAM,eAAe,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,IAAA,aAAQ,EAAkB,eAAe,CAAC,CAAC;IAErE,MAAM,YAAY,GAAG,mBAAmB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,mBAAmB,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAEzE,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC3F,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CACnB,CAAC;IAEF,MAAM,SAAS,GAAyB,EAAE,CAAC;IAC3C,MAAM,sBAAsB,GAAa,EAAE,CAAC;IAE5C,KAAK,MAAM,UAAU,IAAI,kBAAkB,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAA,iCAAe,EAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEvD,OAAO;QACL,SAAS;QACT,sBAAsB;KACvB,CAAC;AACJ,CAAC"}

package/dist/implementation/doctor/evaluator.d.ts

@@ -0,0 +1,16 @@
+export type DoctorCheck = {
+    name: string;
+    status: "pass" | "fail";
+    details: string;
+};
+export type DoctorProviderReport = {
+    provider: string;
+    level: number;
+    maxLevel: number;
+    checks: DoctorCheck[];
+    recommendations: string[];
+};
+export type DoctorReport = {
+    providers: DoctorProviderReport[];
+};
+export declare function runDoctor(cwd: string): Promise<DoctorReport>;