@ankhorage/orchestrator 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { EnsurePackagesAction, JsonSetAction, ModuleAction, ModuleDependency, PatchTextBlockAction, WriteFileInstruction, WriteFilesAction, } from "./actions/types";
+export { LEDGER_DIR, ledgerPath } from "./ledger/helpers";
+export type { AppliedOperation, ModuleLedger } from "./ledger/types";
+export { defineModule } from "./module/defineModule";
+export type { ModuleContext, ModuleDefinition } from "./module/types";
+export { createOrchestrator, type CreateOrchestratorOptions, type InstallModuleOptions, type InstallModuleResult, type Orchestrator, type RemoveModuleResult, } from "./orchestrator/createOrchestrator";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { LEDGER_DIR, ledgerPath } from "./ledger/helpers";
+export { defineModule } from "./module/defineModule";
+export { createOrchestrator, } from "./orchestrator/createOrchestrator";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EACL,kBAAkB,GAMnB,MAAM,mCAAmC,CAAC"}

package/dist/ledger/helpers.d.ts

@@ -0,0 +1,3 @@
+export declare const LEDGER_DIR = ".ankh/ledger";
+export declare function ledgerPath(moduleId: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/ledger/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/ledger/helpers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,iBAAiB,CAAC;AAEzC,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/ledger/helpers.js

@@ -0,0 +1,5 @@
+export const LEDGER_DIR = ".ankh/ledger";
+export function ledgerPath(moduleId) {
+    return `${LEDGER_DIR}/${moduleId}.json`;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/ledger/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/ledger/helpers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAEzC,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,GAAG,UAAU,IAAI,QAAQ,OAAO,CAAC;AAC1C,CAAC"}

package/dist/ledger/types.d.ts

@@ -0,0 +1,42 @@
+import type { ModuleAction } from "../actions/types";
+export interface PackageAdditionOperation {
+    kind: "pkg-add";
+    name: string;
+    version?: string;
+    dev?: boolean;
+}
+export interface FileWriteOperation {
+    kind: "file-write";
+    path: string;
+    prevContent: string | null;
+}
+export interface TextBlockInsertOperation {
+    kind: "text-block-insert";
+    path: string;
+    blockId: string;
+    created: boolean;
+}
+export interface JsonSetOperation {
+    kind: "json-set";
+    path: string;
+    jsonPath: string;
+    prevExists: boolean;
+    prev: unknown;
+    next: unknown;
+}
+export interface JsonFileSnapshotOperation {
+    kind: "json-file-snapshot";
+    path: string;
+    prevContent: string | null;
+}
+export type AppliedOperation = PackageAdditionOperation | FileWriteOperation | TextBlockInsertOperation | JsonSetOperation | JsonFileSnapshotOperation;
+export interface ModuleLedger {
+    moduleId: string;
+    moduleVersion?: string;
+    installedAt: string;
+    config: unknown;
+    dependencies: string[];
+    actions: ModuleAction[];
+    applied: AppliedOperation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ledger/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ledger/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,GAChB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B"}

package/dist/ledger/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ledger/types.js.map

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

package/dist/module/defineModule.d.ts

@@ -0,0 +1,3 @@
+import type { ModuleDefinition } from "./types";
+export declare function defineModule<TConfig = unknown>(moduleDefinition: ModuleDefinition<TConfig>): ModuleDefinition<TConfig>;
+//# sourceMappingURL=defineModule.d.ts.map

package/dist/module/defineModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineModule.d.ts","sourceRoot":"","sources":["../../src/module/defineModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,wBAAgB,YAAY,CAAC,OAAO,GAAG,OAAO,EAC5C,gBAAgB,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAC1C,gBAAgB,CAAC,OAAO,CAAC,CAE3B"}

package/dist/module/defineModule.js

@@ -0,0 +1,4 @@
+export function defineModule(moduleDefinition) {
+    return moduleDefinition;
+}
+//# sourceMappingURL=defineModule.js.map

package/dist/module/defineModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineModule.js","sourceRoot":"","sources":["../../src/module/defineModule.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,gBAA2C;IAE3C,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/module/types.d.ts

@@ -0,0 +1,13 @@
+import type { ModuleAction } from "../actions/types";
+export interface ModuleContext<TConfig = unknown> {
+    projectRoot: string;
+    moduleId: string;
+    config: TConfig;
+}
+export interface ModuleDefinition<TConfig = unknown> {
+    id: string;
+    version?: string;
+    dependencies?: string[];
+    plan(context: ModuleContext<TConfig>): Promise<ModuleAction[]> | ModuleAction[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/module/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/module/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CACF,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC;CAC7C"}

package/dist/module/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/module/types.js.map

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

package/dist/orchestrator/actionExecutor.d.ts

@@ -0,0 +1,11 @@
+import type { ModuleAction } from "../actions/types";
+import type { CommandExecutor, FileSystem } from "../fs/types";
+import type { AppliedOperation } from "../ledger/types";
+export declare function executeModuleActions(args: {
+    projectRoot: string;
+    actions: ModuleAction[];
+    fileSystem: FileSystem;
+    commandExecutor: CommandExecutor;
+    moduleId: string;
+}): Promise<AppliedOperation[]>;
+//# sourceMappingURL=actionExecutor.d.ts.map

package/dist/orchestrator/actionExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionExecutor.d.ts","sourceRoot":"","sources":["../../src/orchestrator/actionExecutor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIxD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgI9B"}

package/dist/orchestrator/actionExecutor.js

@@ -0,0 +1,203 @@
+import path from "node:path";
+import { deepEqual, getAtPath, hasPath, setAtPath } from "../actions/jsonPath";
+import { insertTextBlock } from "../fs/patchTextBlock";
+import { resolveProjectPath } from "../fs/paths";
+export async function executeModuleActions(args) {
+    const { projectRoot, actions, fileSystem, commandExecutor, moduleId } = args;
+    const applied = [];
+    const jsonSnapshots = new Set();
+    const jsonBuffer = new Map();
+    const flushJson = async () => {
+        for (const [relativePath, value] of jsonBuffer.entries()) {
+            const absolutePath = resolveProjectPath(projectRoot, relativePath);
+            await fileSystem.writeJson(absolutePath, value.doc);
+        }
+        jsonBuffer.clear();
+    };
+    try {
+        for (const action of actions) {
+            switch (action.type) {
+                case "write-files": {
+                    await flushJson();
+                    for (const file of action.files) {
+                        const absolutePath = resolveProjectPath(projectRoot, file.path);
+                        const prevContent = await fileSystem.readText(absolutePath);
+                        const exists = prevContent !== null;
+                        if (exists && !file.overwrite) {
+                            continue;
+                        }
+                        await fileSystem.ensureDir(path.dirname(absolutePath));
+                        await fileSystem.writeText(absolutePath, file.content);
+                        applied.push({
+                            kind: "file-write",
+                            path: file.path,
+                            prevContent,
+                        });
+                    }
+                    break;
+                }
+                case "patch-text-block": {
+                    await flushJson();
+                    const absolutePath = resolveProjectPath(projectRoot, action.path);
+                    const existed = await fileSystem.exists(absolutePath);
+                    await insertTextBlock({
+                        fileSystem,
+                        filePath: absolutePath,
+                        blockId: action.blockId,
+                        content: action.content,
+                        anchor: action.anchor,
+                    });
+                    applied.push({
+                        kind: "text-block-insert",
+                        path: action.path,
+                        blockId: action.blockId,
+                        created: !existed,
+                    });
+                    break;
+                }
+                case "json-set": {
+                    await stageJsonSet({
+                        action,
+                        projectRoot,
+                        fileSystem,
+                        jsonBuffer,
+                        jsonSnapshots,
+                        applied,
+                    });
+                    break;
+                }
+                case "ensure-packages": {
+                    await flushJson();
+                    for (const dependency of action.add) {
+                        const args = ["add"];
+                        if (dependency.dev) {
+                            args.push("-d");
+                        }
+                        args.push(`${dependency.name}${dependency.version ? `@${dependency.version}` : ""}`);
+                        const result = await commandExecutor.exec(projectRoot, "bun", args);
+                        if (result.code !== 0) {
+                            throw new Error(`Package install failed for ${dependency.name} (${moduleId}): ${result.stderr || result.stdout}`);
+                        }
+                        applied.push({
+                            kind: "pkg-add",
+                            name: dependency.name,
+                            version: dependency.version,
+                            dev: dependency.dev,
+                        });
+                    }
+                    break;
+                }
+                default: {
+                    const exhaustive = action;
+                    return exhaustive;
+                }
+            }
+        }
+        await flushJson();
+        return applied;
+    }
+    catch (error) {
+        await flushJson();
+        await rollbackAppliedOperations({
+            projectRoot,
+            applied,
+            fileSystem,
+            commandExecutor,
+            moduleId,
+        });
+        throw error;
+    }
+}
+async function rollbackAppliedOperations(args) {
+    const { projectRoot, applied, fileSystem, commandExecutor, moduleId } = args;
+    for (const operation of [...applied].reverse()) {
+        switch (operation.kind) {
+            case "file-write": {
+                if (operation.prevContent === null) {
+                    await fileSystem.remove(resolveProjectPath(projectRoot, operation.path));
+                }
+                else {
+                    await fileSystem.writeText(resolveProjectPath(projectRoot, operation.path), operation.prevContent);
+                }
+                break;
+            }
+            case "text-block-insert": {
+                if (operation.created) {
+                    await fileSystem.remove(resolveProjectPath(projectRoot, operation.path));
+                }
+                else {
+                    const absolutePath = resolveProjectPath(projectRoot, operation.path);
+                    const { removeTextBlock } = await import("../fs/patchTextBlock");
+                    await removeTextBlock({
+                        fileSystem,
+                        filePath: absolutePath,
+                        blockId: operation.blockId,
+                    });
+                }
+                break;
+            }
+            case "pkg-add": {
+                const result = await commandExecutor.exec(projectRoot, "bun", [
+                    "remove",
+                    operation.name,
+                ]);
+                if (result.code !== 0) {
+                    throw new Error(`Package uninstall failed for ${operation.name} (${moduleId}): ${result.stderr || result.stdout}`);
+                }
+                break;
+            }
+            case "json-file-snapshot": {
+                const absolutePath = resolveProjectPath(projectRoot, operation.path);
+                if (operation.prevContent === null) {
+                    await fileSystem.remove(absolutePath);
+                }
+                else {
+                    await fileSystem.writeText(absolutePath, operation.prevContent);
+                }
+                break;
+            }
+            case "json-set": {
+                break;
+            }
+            default: {
+                const exhaustive = operation;
+                return exhaustive;
+            }
+        }
+    }
+}
+async function stageJsonSet(args) {
+    const { action, projectRoot, fileSystem, jsonBuffer, jsonSnapshots, applied, } = args;
+    const absolutePath = resolveProjectPath(projectRoot, action.path);
+    if (!jsonSnapshots.has(action.path)) {
+        const prevContent = await fileSystem.readText(absolutePath);
+        applied.push({
+            kind: "json-file-snapshot",
+            path: action.path,
+            prevContent,
+        });
+        jsonSnapshots.add(action.path);
+    }
+    let buffer = jsonBuffer.get(action.path);
+    if (!buffer) {
+        const doc = (await fileSystem.readJson(absolutePath)) ?? {};
+        buffer = { doc };
+        jsonBuffer.set(action.path, buffer);
+    }
+    const current = getAtPath(buffer.doc, action.jsonPath);
+    if (action.expected !== undefined && !deepEqual(current, action.expected)) {
+        throw new Error(`JSON path mismatch at ${action.path}:${action.jsonPath}. Expected ${JSON.stringify(action.expected)}, found ${JSON.stringify(current)}`);
+    }
+    const prev = current;
+    const prevExists = hasPath(buffer.doc, action.jsonPath);
+    buffer.doc = setAtPath(buffer.doc, action.jsonPath, action.value, action.createMissing ?? true);
+    applied.push({
+        kind: "json-set",
+        path: action.path,
+        jsonPath: action.jsonPath,
+        prevExists,
+        prev,
+        next: action.value,
+    });
+}
+//# sourceMappingURL=actionExecutor.js.map

package/dist/orchestrator/actionExecutor.js.map

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

package/dist/orchestrator/createOrchestrator.d.ts

@@ -0,0 +1,22 @@
+import type { OrchestratorServices } from "../fs/types";
+import type { ModuleDefinition } from "../module/types";
+export interface CreateOrchestratorOptions {
+    modules: ModuleDefinition[];
+    projectRoot: string;
+}
+export interface InstallModuleOptions<TConfig = unknown> {
+    config: TConfig;
+}
+export interface InstallModuleResult {
+    installed: string[];
+}
+export interface RemoveModuleResult {
+    removed: string[];
+}
+export interface Orchestrator {
+    installModule(moduleId: string, options: InstallModuleOptions): Promise<InstallModuleResult>;
+    removeModule(moduleId: string): Promise<RemoveModuleResult>;
+}
+export declare function createOrchestrator(options: CreateOrchestratorOptions): Orchestrator;
+export declare function createOrchestratorWithServices(options: CreateOrchestratorOptions, services: OrchestratorServices): Orchestrator;
+//# sourceMappingURL=createOrchestrator.d.ts.map

package/dist/orchestrator/createOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOrchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/createOrchestrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACrD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAKd;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,oBAAoB,GAC7B,YAAY,CAgHd"}

package/dist/orchestrator/createOrchestrator.js

@@ -0,0 +1,154 @@
+import { NodeCommandExecutor } from "../fs/exec";
+import { NodeFileSystem } from "../fs/fileSystem";
+import { resolveProjectPath } from "../fs/paths";
+import { ledgerPath } from "../ledger/helpers";
+import { executeModuleActions } from "./actionExecutor";
+import { createModuleRegistry, resolveInstallOrder } from "./dependencyGraph";
+import { uninstallFromLedger } from "./uninstall";
+export function createOrchestrator(options) {
+    return createOrchestratorWithServices(options, {
+        fileSystem: new NodeFileSystem(),
+        commandExecutor: new NodeCommandExecutor(),
+    });
+}
+export function createOrchestratorWithServices(options, services) {
+    const registry = createModuleRegistry(options.modules);
+    const { fileSystem } = services;
+    const { commandExecutor } = services;
+    const now = services.now ?? (() => new Date().toISOString());
+    return {
+        async installModule(moduleId, installOptions) {
+            const requestedModule = registry.get(moduleId);
+            if (!requestedModule) {
+                throw new Error(`Unknown module "${moduleId}".`);
+            }
+            const installOrder = resolveInstallOrder(moduleId, registry);
+            const requestedLedger = await readLedger(options.projectRoot, moduleId, fileSystem);
+            if (requestedLedger) {
+                await removeInstalledModule({
+                    projectRoot: options.projectRoot,
+                    moduleId,
+                    fileSystem,
+                    commandExecutor,
+                    skipDependencyCheck: true,
+                });
+            }
+            const installedDuringOperation = [];
+            try {
+                for (const moduleDefinition of installOrder) {
+                    const existingLedger = await readLedger(options.projectRoot, moduleDefinition.id, fileSystem);
+                    if (moduleDefinition.id !== moduleId && existingLedger) {
+                        continue;
+                    }
+                    const config = moduleDefinition.id === moduleId
+                        ? installOptions.config
+                        : (existingLedger?.config ?? {});
+                    const actions = await moduleDefinition.plan({
+                        projectRoot: options.projectRoot,
+                        moduleId: moduleDefinition.id,
+                        config,
+                    });
+                    const applied = await executeModuleActions({
+                        projectRoot: options.projectRoot,
+                        actions,
+                        fileSystem,
+                        commandExecutor,
+                        moduleId: moduleDefinition.id,
+                    });
+                    const ledger = {
+                        moduleId: moduleDefinition.id,
+                        moduleVersion: moduleDefinition.version,
+                        installedAt: now(),
+                        config,
+                        dependencies: [
+                            ...new Set(moduleDefinition.dependencies ?? []),
+                        ].sort((left, right) => left.localeCompare(right)),
+                        actions,
+                        applied,
+                    };
+                    await writeLedger(options.projectRoot, ledger, fileSystem);
+                    installedDuringOperation.push(moduleDefinition.id);
+                }
+                return {
+                    installed: installedDuringOperation,
+                };
+            }
+            catch (error) {
+                for (const installedModuleId of [
+                    ...installedDuringOperation,
+                ].reverse()) {
+                    await removeInstalledModule({
+                        projectRoot: options.projectRoot,
+                        moduleId: installedModuleId,
+                        fileSystem,
+                        commandExecutor,
+                        skipDependencyCheck: true,
+                    });
+                }
+                throw error;
+            }
+        },
+        async removeModule(moduleId) {
+            await removeInstalledModule({
+                projectRoot: options.projectRoot,
+                moduleId,
+                fileSystem,
+                commandExecutor,
+                skipDependencyCheck: false,
+            });
+            return {
+                removed: [moduleId],
+            };
+        },
+    };
+}
+async function removeInstalledModule(args) {
+    const { projectRoot, moduleId, fileSystem, commandExecutor, skipDependencyCheck, } = args;
+    const ledger = await readLedger(projectRoot, moduleId, fileSystem);
+    if (!ledger) {
+        throw new Error(`Module "${moduleId}" is not installed.`);
+    }
+    if (!skipDependencyCheck) {
+        const installedLedgers = await listLedgers(projectRoot, fileSystem);
+        const dependents = installedLedgers
+            .filter((candidate) => candidate.moduleId !== moduleId &&
+            candidate.dependencies.includes(moduleId))
+            .map((candidate) => candidate.moduleId)
+            .sort((left, right) => left.localeCompare(right));
+        if (dependents.length > 0) {
+            throw new Error(`Cannot remove "${moduleId}" while installed modules still depend on it: ${dependents.join(", ")}`);
+        }
+    }
+    await uninstallFromLedger({
+        projectRoot,
+        ledger,
+        fileSystem,
+        commandExecutor,
+    });
+    await deleteLedger(projectRoot, moduleId, fileSystem);
+}
+async function readLedger(projectRoot, moduleId, fileSystem) {
+    return fileSystem.readJson(resolveProjectPath(projectRoot, ledgerPath(moduleId)));
+}
+async function writeLedger(projectRoot, ledger, fileSystem) {
+    await fileSystem.writeJson(resolveProjectPath(projectRoot, ledgerPath(ledger.moduleId)), ledger);
+}
+async function deleteLedger(projectRoot, moduleId, fileSystem) {
+    await fileSystem.remove(resolveProjectPath(projectRoot, ledgerPath(moduleId)));
+}
+async function listLedgers(projectRoot, fileSystem) {
+    const ledgerDirectory = resolveProjectPath(projectRoot, ".ankh/ledger");
+    const entries = await fileSystem.readDir(ledgerDirectory);
+    const ledgers = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".json")) {
+            continue;
+        }
+        const text = await fileSystem.readJson(resolveProjectPath(projectRoot, `.ankh/ledger/${entry}`));
+        if (text) {
+            ledgers.push(text);
+        }
+    }
+    return ledgers;
+}
+//# sourceMappingURL=createOrchestrator.js.map

package/dist/orchestrator/createOrchestrator.js.map

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

package/dist/orchestrator/dependencyGraph.d.ts

@@ -0,0 +1,4 @@
+import type { ModuleDefinition } from "../module/types";
+export declare function createModuleRegistry(modules: ModuleDefinition[]): Map<string, ModuleDefinition>;
+export declare function resolveInstallOrder(moduleId: string, registry: Map<string, ModuleDefinition>): ModuleDefinition[];
+//# sourceMappingURL=dependencyGraph.d.ts.map

package/dist/orchestrator/dependencyGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyGraph.d.ts","sourceRoot":"","sources":["../../src/orchestrator/dependencyGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EAAE,GAC1B,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAW/B;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACtC,gBAAgB,EAAE,CAgDpB"}

package/dist/orchestrator/dependencyGraph.js

@@ -0,0 +1,44 @@
+export function createModuleRegistry(modules) {
+    const registry = new Map();
+    for (const moduleDefinition of modules) {
+        if (registry.has(moduleDefinition.id)) {
+            throw new Error(`Duplicate module definition "${moduleDefinition.id}".`);
+        }
+        registry.set(moduleDefinition.id, moduleDefinition);
+    }
+    return registry;
+}
+export function resolveInstallOrder(moduleId, registry) {
+    if (!registry.has(moduleId)) {
+        throw new Error(`Unknown module "${moduleId}".`);
+    }
+    const resolved = new Set();
+    const visiting = new Set();
+    const order = [];
+    const visit = (currentId, stack) => {
+        if (resolved.has(currentId)) {
+            return;
+        }
+        if (visiting.has(currentId)) {
+            throw new Error(`Dependency cycle detected: ${[...stack, currentId].join(" -> ")}`);
+        }
+        const moduleDefinition = registry.get(currentId);
+        if (!moduleDefinition) {
+            throw new Error(`Missing dependency "${currentId}".`);
+        }
+        visiting.add(currentId);
+        const dependencies = [...new Set(moduleDefinition.dependencies ?? [])].sort((left, right) => left.localeCompare(right));
+        for (const dependencyId of dependencies) {
+            if (!registry.has(dependencyId)) {
+                throw new Error(`Module "${moduleDefinition.id}" depends on missing module "${dependencyId}".`);
+            }
+            visit(dependencyId, [...stack, currentId]);
+        }
+        visiting.delete(currentId);
+        resolved.add(currentId);
+        order.push(moduleDefinition);
+    };
+    visit(moduleId, []);
+    return order;
+}
+//# sourceMappingURL=dependencyGraph.js.map

package/dist/orchestrator/dependencyGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyGraph.js","sourceRoot":"","sources":["../../src/orchestrator/dependencyGraph.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,OAA2B;IAE3B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAErD,KAAK,MAAM,gBAAgB,IAAI,OAAO,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,gBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,QAAuC;IAEvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,KAAK,GAAuB,EAAE,CAAC;IAErC,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAE,KAAe,EAAE,EAAE;QACnD,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,8BAA8B,CAAC,GAAG,KAAK,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CACnE,CAAC;QACJ,CAAC;QAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,uBAAuB,SAAS,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAExB,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CACzE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC3C,CAAC;QAEF,KAAK,MAAM,YAAY,IAAI,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,WAAW,gBAAgB,CAAC,EAAE,gCAAgC,YAAY,IAAI,CAC/E,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEF,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEpB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/orchestrator/uninstall.d.ts

@@ -0,0 +1,9 @@
+import type { CommandExecutor, FileSystem } from "../fs/types";
+import type { ModuleLedger } from "../ledger/types";
+export declare function uninstallFromLedger(args: {
+    projectRoot: string;
+    ledger: ModuleLedger;
+    fileSystem: FileSystem;
+    commandExecutor: CommandExecutor;
+}): Promise<void>;
+//# sourceMappingURL=uninstall.d.ts.map