@ankhorage/orchestrator 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankhorage
+
+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,139 @@
+# @ankhorage/orchestrator
+
+`@ankhorage/orchestrator` is the standalone engine extracted and redesigned from the relevant contract and execution concepts in `../ankhorage4/packages/plugin-kit` and the CLI runtime helpers.
+
+The package has one job: execute module plans against a project root, track the applied work in `.ankh/ledger/<moduleId>.json`, and reverse that work deterministically on removal.
+
+## Architecture
+
+- Orchestrator: owns the loaded module registry, resolves dependencies, installs modules, removes modules, and writes the ledger.
+- Modules: pure planners that return actions from `plan(ctx)`.
+- Host: loads module definitions, gathers config, and triggers `installModule` / `removeModule`.
+
+The orchestrator does not know templates, UI, Studio, Expo layout generation, or runtime-specific behavior.
+
+## Public API
+
+```ts
+import { createOrchestrator, defineModule } from "@ankhorage/orchestrator";
+
+const localizationModule = defineModule({
+  id: "expo-localization",
+  dependencies: ["base-i18n"],
+  async plan(ctx) {
+    return [
+      {
+        type: "write-files",
+        files: [
+          {
+            path: "src/modules/localization/index.ts",
+            content: "export const ready = true;\n",
+            overwrite: true,
+          },
+        ],
+      },
+    ];
+  },
+});
+
+const orchestrator = createOrchestrator({
+  modules: [localizationModule],
+  projectRoot: "/absolute/path/to/project",
+});
+
+await orchestrator.installModule("expo-localization", {
+  config: { defaultLocale: "en" },
+});
+
+await orchestrator.removeModule("expo-localization");
+```
+
+### Module contract
+
+```ts
+defineModule({
+  id: string,
+  version?: string,
+  dependencies?: string[],
+  plan(ctx): ModuleAction[] | Promise<ModuleAction[]>
+})
+```
+
+`plan(ctx)` receives:
+
+- `projectRoot`
+- `moduleId`
+- `config`
+
+The host only passes `config`; the orchestrator injects the rest.
+
+### Supported actions
+
+V1 supports exactly these actions:
+
+- `ensure-packages`
+- `write-files`
+- `json-set`
+- `patch-text-block`
+
+Package execution is internal infrastructure only. The orchestrator uses safe `bun add` / `bun remove` argument arrays under `src/fs/exec.ts` and does not expose an adapter API.
+
+## Ledger behavior
+
+Each installed module writes `.ankh/ledger/<moduleId>.json`.
+
+Every ledger entry stores:
+
+- `moduleId`
+- `moduleVersion`
+- `installedAt`
+- `config`
+- `dependencies`
+- `actions`
+- `applied`
+
+The `applied` section is the source of truth for rollback. Removal never recomputes a module plan.
+
+## Install and remove semantics
+
+- Dependency resolution belongs to the orchestrator, not the host.
+- Missing declared dependencies fail the install before any execution starts.
+- Dependencies are installed before the requested module.
+- Removal is immediate. The orchestrator reads the ledger, replays rollback operations, and deletes the ledger file.
+- Removal is blocked if another installed module still depends on the target module.
+
+### Replace-style reinstall
+
+If `installModule()` is called for a module that is already installed, the orchestrator removes the existing installed state first and then runs the new plan.
+
+This behavior is intentional in v1 and has an important consequence:
+
+- if the reinstall fails after the prior state was removed, the module remains removed
+
+Fresh installs behave differently:
+
+- if a fresh install fails part-way through, the orchestrator rolls back the new partial work and leaves no orchestrator-managed residue behind
+
+## Development
+
+This repo uses:
+
+- `@ankhorage/devtools` for lint and prettier alignment
+- `@changesets/cli` for versioning
+
+Run the quality gates with:
+
+```sh
+bun install
+bun run build
+bun run lint
+bun run test
+bunx knip
+```
+
+## Repo-switch rule
+
+Work in this repo stops once the orchestrator package is release-ready.
+
+Module extraction must happen later in dedicated repos such as `@ankhorage/orchestrator-module-expo-localization`. When that work starts, the current repo is no longer the right place to continue. The next step must be an explicit repository switch request before any module-repo changes are made.
+

package/dist/actions/jsonPath.d.ts

@@ -0,0 +1,5 @@
+export declare function getAtPath(obj: Record<string, unknown>, path: string): unknown;
+export declare function hasPath(obj: Record<string, unknown>, path: string): boolean;
+export declare function setAtPath(obj: Record<string, unknown>, path: string, value: unknown, createMissing?: boolean): Record<string, unknown>;
+export declare function deepEqual(left: unknown, right: unknown): boolean;
+//# sourceMappingURL=jsonPath.d.ts.map

package/dist/actions/jsonPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonPath.d.ts","sourceRoot":"","sources":["../../src/actions/jsonPath.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAY7E;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAkB3E;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,aAAa,UAAO,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuDzB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAkDhE"}

package/dist/actions/jsonPath.js

@@ -0,0 +1,148 @@
+function parseJsonPath(path) {
+    return path
+        .replace(/\[(\d+)\]/g, ".$1")
+        .split(".")
+        .filter(Boolean);
+}
+export function getAtPath(obj, path) {
+    const parts = parseJsonPath(path);
+    let current = obj;
+    for (const part of parts) {
+        if (!isJsonContainer(current)) {
+            return undefined;
+        }
+        current = getContainerValue(current, part);
+    }
+    return current;
+}
+export function hasPath(obj, path) {
+    const parts = parseJsonPath(path);
+    let current = obj;
+    for (let index = 0; index < parts.length; index += 1) {
+        const part = parts[index];
+        if (part === undefined || !isJsonContainer(current)) {
+            return false;
+        }
+        if (index === parts.length - 1) {
+            return hasContainerKey(current, part);
+        }
+        current = getContainerValue(current, part);
+    }
+    return false;
+}
+export function setAtPath(obj, path, value, createMissing = true) {
+    const parts = parseJsonPath(path);
+    if (parts.length === 0) {
+        return obj;
+    }
+    const result = { ...obj };
+    let current = result;
+    for (let index = 0; index < parts.length; index += 1) {
+        const part = parts[index];
+        if (part === undefined) {
+            return obj;
+        }
+        const isLast = index === parts.length - 1;
+        if (Array.isArray(current)) {
+            const arrayIndex = Number(part);
+            if (!Number.isInteger(arrayIndex) || arrayIndex < 0) {
+                throw new Error(`Invalid array index: ${part}`);
+            }
+            if (arrayIndex > current.length) {
+                throw new Error(`Sparse array jump disallowed at index ${arrayIndex} in path ${path}`);
+            }
+        }
+        if (isLast) {
+            setContainerValue(current, part, value);
+            continue;
+        }
+        const existing = getContainerValue(current, part);
+        let next;
+        if (!isJsonContainer(existing)) {
+            if (!createMissing) {
+                throw new Error(`Path segment "${part}" missing and createMissing is false`);
+            }
+            const nextPart = parts[index + 1];
+            next = nextPart !== undefined && /^\d+$/.test(nextPart) ? [] : {};
+        }
+        else {
+            next = cloneContainer(existing);
+        }
+        setContainerValue(current, part, next);
+        current = next;
+    }
+    return result;
+}
+export function deepEqual(left, right) {
+    if (left === right) {
+        return true;
+    }
+    if (typeof left !== typeof right) {
+        return false;
+    }
+    if (left === null || right === null) {
+        return left === right;
+    }
+    if (typeof left !== "object") {
+        return left === right;
+    }
+    if (Array.isArray(left)) {
+        if (!Array.isArray(right) || left.length !== right.length) {
+            return false;
+        }
+        for (let index = 0; index < left.length; index += 1) {
+            if (!deepEqual(left[index], right[index])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    const leftRecord = left;
+    const rightRecord = right;
+    const leftKeys = Object.keys(leftRecord);
+    const rightKeys = Object.keys(rightRecord);
+    if (leftKeys.length !== rightKeys.length) {
+        return false;
+    }
+    for (const key of leftKeys) {
+        if (!(key in rightRecord)) {
+            return false;
+        }
+        if (!deepEqual(leftRecord[key], rightRecord[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+function isJsonContainer(value) {
+    return typeof value === "object" && value !== null;
+}
+function cloneContainer(value) {
+    return Array.isArray(value) ? [...value] : { ...value };
+}
+function getContainerValue(container, key) {
+    if (Array.isArray(container)) {
+        const index = Number(key);
+        return Number.isInteger(index) && index >= 0 ? container[index] : undefined;
+    }
+    return container[key];
+}
+function setContainerValue(container, key, value) {
+    if (Array.isArray(container)) {
+        const index = Number(key);
+        if (!Number.isInteger(index) || index < 0) {
+            throw new Error(`Invalid array index: ${key}`);
+        }
+        container[index] = value;
+        return;
+    }
+    container[key] = value;
+}
+function hasContainerKey(container, key) {
+    if (Array.isArray(container)) {
+        const index = Number(key);
+        return Number.isInteger(index) && index >= 0 && index in container;
+    }
+    return key in container;
+}
+//# sourceMappingURL=jsonPath.js.map

package/dist/actions/jsonPath.js.map

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

package/dist/actions/types.d.ts

@@ -0,0 +1,38 @@
+export interface ModuleDependency {
+    name: string;
+    version?: string;
+    dev?: boolean;
+}
+export interface EnsurePackagesAction {
+    type: "ensure-packages";
+    add: ModuleDependency[];
+}
+export interface WriteFileInstruction {
+    path: string;
+    content: string;
+    overwrite?: boolean;
+}
+export interface WriteFilesAction {
+    type: "write-files";
+    files: WriteFileInstruction[];
+}
+export interface JsonSetAction {
+    type: "json-set";
+    path: string;
+    jsonPath: string;
+    value: unknown;
+    createMissing?: boolean;
+    expected?: unknown;
+}
+export interface PatchTextBlockAction {
+    type: "patch-text-block";
+    path: string;
+    blockId: string;
+    content: string;
+    anchor?: {
+        find: string;
+        position: "before" | "after";
+    };
+}
+export type ModuleAction = EnsurePackagesAction | WriteFilesAction | JsonSetAction | PatchTextBlockAction;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/actions/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,CAAC;IACxB,GAAG,EAAE,gBAAgB,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,aAAa,GACb,oBAAoB,CAAC"}

package/dist/actions/types.js

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

package/dist/actions/types.js.map

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

package/dist/fs/exec.d.ts

@@ -0,0 +1,9 @@
+import type { CommandExecutor } from "./types";
+export declare class NodeCommandExecutor implements CommandExecutor {
+    exec(cwd: string, command: string, args: string[]): Promise<{
+        code: number;
+        stdout: string;
+        stderr: string;
+    }>;
+}
+//# sourceMappingURL=exec.d.ts.map

package/dist/fs/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/fs/exec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,qBAAa,mBAAoB,YAAW,eAAe;IACnD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;;;;;CAoBxD"}

package/dist/fs/exec.js

@@ -0,0 +1,26 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { promisify } from "node:util";
+const execFile = promisify(execFileCallback);
+export class NodeCommandExecutor {
+    async exec(cwd, command, args) {
+        try {
+            const { stdout, stderr } = await execFile(command, args, { cwd });
+            return { code: 0, stdout, stderr };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return {
+                    code: 1,
+                    stdout: "",
+                    stderr: error.message,
+                };
+            }
+            return {
+                code: 1,
+                stdout: "",
+                stderr: "Unknown exec error",
+            };
+        }
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/fs/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/fs/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAE7C,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,OAAe,EAAE,IAAc;QACrD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,OAAO;oBACL,IAAI,EAAE,CAAC;oBACP,MAAM,EAAE,EAAE;oBACV,MAAM,EAAE,KAAK,CAAC,OAAO;iBACtB,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,CAAC;gBACP,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,oBAAoB;aAC7B,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/fs/fileSystem.d.ts

@@ -0,0 +1,12 @@
+import type { FileSystem } from "./types";
+export declare class NodeFileSystem implements FileSystem {
+    exists(filePath: string): Promise<boolean>;
+    readText(filePath: string): Promise<string | null>;
+    writeText(filePath: string, content: string): Promise<void>;
+    ensureDir(dirPath: string): Promise<void>;
+    remove(targetPath: string): Promise<void>;
+    readJson<T>(filePath: string): Promise<T | null>;
+    writeJson(filePath: string, value: unknown): Promise<void>;
+    readDir(dirPath: string): Promise<string[]>;
+}
+//# sourceMappingURL=fileSystem.d.ts.map

package/dist/fs/fileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystem.d.ts","sourceRoot":"","sources":["../../src/fs/fileSystem.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,qBAAa,cAAe,YAAW,UAAU;IACzC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQlD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAShD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAOlD"}

package/dist/fs/fileSystem.js

@@ -0,0 +1,51 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+export class NodeFileSystem {
+    async exists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readText(filePath) {
+        try {
+            return await fs.readFile(filePath, "utf8");
+        }
+        catch {
+            return null;
+        }
+    }
+    async writeText(filePath, content) {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, content, "utf8");
+    }
+    async ensureDir(dirPath) {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    async remove(targetPath) {
+        await fs.rm(targetPath, { recursive: true, force: true });
+    }
+    async readJson(filePath) {
+        const text = await this.readText(filePath);
+        if (text === null) {
+            return null;
+        }
+        return JSON.parse(text);
+    }
+    async writeJson(filePath, value) {
+        const content = `${JSON.stringify(value, null, 2).replace(/\r\n/g, "\n")}\n`;
+        await this.writeText(filePath, content);
+    }
+    async readDir(dirPath) {
+        try {
+            return await fs.readdir(dirPath);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=fileSystem.js.map

package/dist/fs/fileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystem.js","sourceRoot":"","sources":["../../src/fs/fileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,OAAe;QAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,MAAM,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAI,QAAgB;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,KAAc;QAC9C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC;QAC7E,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/fs/patchTextBlock.d.ts

@@ -0,0 +1,19 @@
+import type { FileSystem } from "./types";
+interface PatchAnchor {
+    find: string;
+    position: "before" | "after";
+}
+export declare function insertTextBlock(args: {
+    fileSystem: FileSystem;
+    filePath: string;
+    blockId: string;
+    content: string;
+    anchor?: PatchAnchor;
+}): Promise<void>;
+export declare function removeTextBlock(args: {
+    fileSystem: FileSystem;
+    filePath: string;
+    blockId: string;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=patchTextBlock.d.ts.map

package/dist/fs/patchTextBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchTextBlock.d.ts","sourceRoot":"","sources":["../../src/fs/patchTextBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC9B;AAUD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB"}

package/dist/fs/patchTextBlock.js

@@ -0,0 +1,46 @@
+function startMarker(blockId) {
+    return `// @ankh:block ${blockId}:start`;
+}
+function endMarker(blockId) {
+    return `// @ankh:block ${blockId}:end`;
+}
+export async function insertTextBlock(args) {
+    const { fileSystem, filePath, blockId, content, anchor } = args;
+    const existing = (await fileSystem.readText(filePath)) ?? "";
+    const start = startMarker(blockId);
+    if (existing.includes(start)) {
+        return;
+    }
+    const block = `${start}\n${content}\n${endMarker(blockId)}`;
+    if (anchor) {
+        const index = existing.indexOf(anchor.find);
+        if (index !== -1) {
+            const insertAt = anchor.position === "after" ? index + anchor.find.length : index;
+            const before = existing.slice(0, insertAt);
+            const after = existing.slice(insertAt);
+            const prefix = before.endsWith("\n") || before.length === 0 ? "" : "\n";
+            const suffix = after.startsWith("\n") || after.length === 0 ? "" : "\n";
+            const next = `${before}${prefix}${block}${suffix}${after}`;
+            await fileSystem.writeText(filePath, next);
+            return;
+        }
+    }
+    const prefix = existing.endsWith("\n") || existing.length === 0 ? "" : "\n";
+    await fileSystem.writeText(filePath, `${existing}${prefix}${block}\n`);
+}
+export async function removeTextBlock(args) {
+    const { fileSystem, filePath, blockId } = args;
+    const existing = await fileSystem.readText(filePath);
+    if (existing === null) {
+        return;
+    }
+    const start = escapeForRegex(startMarker(blockId));
+    const end = escapeForRegex(endMarker(blockId));
+    const pattern = new RegExp(`${start}[\\s\\S]*?${end}\\n?`, "g");
+    const next = existing.replace(pattern, "");
+    await fileSystem.writeText(filePath, next);
+}
+function escapeForRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=patchTextBlock.js.map

package/dist/fs/patchTextBlock.js.map

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

package/dist/fs/paths.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveProjectPath(projectRoot: string, relativePath: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/fs/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/fs/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAmBR"}

package/dist/fs/paths.js

@@ -0,0 +1,18 @@
+import path from "node:path";
+export function resolveProjectPath(projectRoot, relativePath) {
+    if (!relativePath || path.isAbsolute(relativePath)) {
+        throw new Error(`Expected a relative project path, received "${relativePath}".`);
+    }
+    const resolved = path.resolve(projectRoot, relativePath);
+    const normalizedRoot = ensureTrailingSeparator(path.resolve(projectRoot));
+    const normalizedResolved = ensureTrailingSeparator(resolved);
+    if (!normalizedResolved.startsWith(normalizedRoot) &&
+        resolved !== path.resolve(projectRoot)) {
+        throw new Error(`Path traversal is not allowed: "${relativePath}".`);
+    }
+    return resolved;
+}
+function ensureTrailingSeparator(value) {
+    return value.endsWith(path.sep) ? value : `${value}${path.sep}`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/fs/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/fs/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,YAAoB;IAEpB,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,+CAA+C,YAAY,IAAI,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1E,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAE7D,IACE,CAAC,kBAAkB,CAAC,UAAU,CAAC,cAAc,CAAC;QAC9C,QAAQ,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EACtC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,YAAY,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAClE,CAAC"}

package/dist/fs/types.d.ts

@@ -0,0 +1,24 @@
+export interface CommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export interface FileSystem {
+    exists(path: string): Promise<boolean>;
+    readText(path: string): Promise<string | null>;
+    writeText(path: string, content: string): Promise<void>;
+    ensureDir(path: string): Promise<void>;
+    remove(path: string): Promise<void>;
+    readJson<T>(path: string): Promise<T | null>;
+    writeJson(path: string, value: unknown): Promise<void>;
+    readDir(path: string): Promise<string[]>;
+}
+export interface CommandExecutor {
+    exec(cwd: string, command: string, args: string[]): Promise<CommandResult>;
+}
+export interface OrchestratorServices {
+    fileSystem: FileSystem;
+    commandExecutor: CommandExecutor;
+    now?: () => string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fs/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB"}

package/dist/fs/types.js

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

package/dist/fs/types.js.map

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