@madebywild/agent-harness-framework 0.9.1

package/dist/versioning/migrate.js

@@ -0,0 +1,362 @@
+import path from "node:path";
+import { detectDocumentVersion, LATEST_VERSION_BY_KIND, parseManifest, parseProviderOverride, } from "@madebywild/agent-harness-manifest";
+import { loadCanonicalState } from "../loader.js";
+import { buildPlan } from "../planner.js";
+import { copyWorkspaceFileToBackup, emptyManagedIndex } from "../repository.js";
+import { readTextIfExists, stableStringify, withSingleTrailingNewline, writeFileAtomic } from "../utils.js";
+import { runDoctor } from "./doctor.js";
+import { defaultMigrationRegistry, resolveMigrationChain, runMigrationChain } from "./registry.js";
+export async function runMigration(paths, options = {}) {
+    if (options.to && options.to !== "latest") {
+        return {
+            success: false,
+            dryRun: options.dryRun === true,
+            actions: [],
+            diagnostics: [
+                {
+                    code: "MIGRATION_TARGET_UNSUPPORTED",
+                    severity: "error",
+                    message: `Unsupported migration target '${options.to}'. Only 'latest' is supported.`,
+                    path: ".harness",
+                },
+            ],
+        };
+    }
+    const dryRun = options.dryRun === true;
+    const doctor = await runDoctor(paths);
+    const actions = [];
+    const unsupported = doctor.files.filter((file) => file.status === "unsupported");
+    if (unsupported.length > 0) {
+        return {
+            success: false,
+            dryRun,
+            actions,
+            diagnostics: [
+                {
+                    code: "MIGRATION_DOWNGRADE_UNSUPPORTED",
+                    severity: "error",
+                    message: "Cannot migrate because one or more files use a newer schema than this CLI supports.",
+                    path: ".harness",
+                    hint: "Install a newer harness CLI and rerun 'harness doctor'.",
+                },
+                ...doctor.diagnostics,
+            ],
+        };
+    }
+    const invalid = doctor.files.filter((file) => file.status === "invalid" || file.status === "missing");
+    if (invalid.length > 0) {
+        return {
+            success: false,
+            dryRun,
+            actions,
+            diagnostics: [
+                {
+                    code: "MIGRATION_BLOCKED_INVALID",
+                    severity: "error",
+                    message: "Migration is blocked by invalid or missing version metadata.",
+                    path: ".harness",
+                    hint: "Fix diagnostics from 'harness doctor' and rerun migration.",
+                },
+                ...doctor.diagnostics,
+            ],
+        };
+    }
+    const outdated = doctor.files.filter((file) => file.status === "outdated");
+    if (outdated.length === 0) {
+        actions.push({
+            kind: "backup",
+            path: ".harness",
+            action: "noop",
+            details: "Workspace is already on latest schema version",
+        });
+        return {
+            success: true,
+            dryRun,
+            actions,
+            diagnostics: [],
+        };
+    }
+    const manifestText = await readTextIfExists(paths.manifestFile);
+    if (manifestText === null) {
+        return {
+            success: false,
+            dryRun,
+            actions,
+            diagnostics: [
+                {
+                    code: "MANIFEST_NOT_FOUND",
+                    severity: "error",
+                    message: "Missing manifest file at .harness/manifest.json",
+                    path: ".harness/manifest.json",
+                    hint: "Run 'harness init' first.",
+                },
+            ],
+        };
+    }
+    let parsedManifest;
+    try {
+        parsedManifest = JSON.parse(manifestText);
+    }
+    catch (error) {
+        return {
+            success: false,
+            dryRun,
+            actions,
+            diagnostics: [
+                {
+                    code: "MANIFEST_INVALID",
+                    severity: "error",
+                    message: error instanceof Error ? error.message : "Manifest must be valid JSON",
+                    path: ".harness/manifest.json",
+                },
+            ],
+        };
+    }
+    let migratedManifest;
+    try {
+        migratedManifest = (await migrateVersionedObject("manifest", parsedManifest));
+    }
+    catch (error) {
+        return {
+            success: false,
+            dryRun,
+            actions,
+            diagnostics: [toMigrationErrorDiagnostic(error, ".harness/manifest.json", "MANIFEST_MIGRATION_FAILED")],
+        };
+    }
+    const pendingWrites = [];
+    for (const file of outdated.filter((status) => status.kind === "provider-override")) {
+        const overrideWrite = await buildOverrideWrite(paths, file);
+        if (overrideWrite.diagnostic) {
+            return {
+                success: false,
+                dryRun,
+                actions,
+                diagnostics: [overrideWrite.diagnostic],
+            };
+        }
+        if (overrideWrite.write) {
+            pendingWrites.push(overrideWrite.write);
+        }
+    }
+    const derived = await deriveLatestState(paths, migratedManifest);
+    if (derived.diagnostics.length > 0) {
+        return {
+            success: false,
+            dryRun,
+            actions,
+            diagnostics: derived.diagnostics,
+        };
+    }
+    const manifestContent = stableStringify(migratedManifest);
+    const lockContent = stableStringify(derived.lock);
+    const managedIndexContent = stableStringify(derived.managedIndex);
+    const manifestWrite = await maybeWrite(paths.root, "manifest", ".harness/manifest.json", manifestContent, "Manifest schema migrated");
+    if (manifestWrite) {
+        pendingWrites.push(manifestWrite);
+    }
+    const lockWrite = await maybeWrite(paths.root, "lock", ".harness/manifest.lock.json", lockContent, "Rebuilt lock from desired outputs");
+    if (lockWrite) {
+        pendingWrites.push(lockWrite);
+    }
+    const managedIndexWrite = await maybeWrite(paths.root, "managed-index", ".harness/managed-index.json", managedIndexContent, "Rebuilt managed-index and adopted desired output paths");
+    if (managedIndexWrite) {
+        pendingWrites.push(managedIndexWrite);
+    }
+    for (const write of pendingWrites) {
+        actions.push({
+            kind: write.kind,
+            path: write.path,
+            action: write.action,
+            details: write.details,
+        });
+    }
+    if (pendingWrites.length === 0) {
+        return {
+            success: true,
+            dryRun,
+            actions: [
+                {
+                    kind: "backup",
+                    path: ".harness",
+                    action: "noop",
+                    details: "No file content changes required",
+                },
+            ],
+            diagnostics: [],
+        };
+    }
+    const backupRoot = path.join(paths.agentsDir, ".backup", migrationTimestamp());
+    const backupTargets = [];
+    for (const write of pendingWrites) {
+        const existing = await readTextIfExists(path.join(paths.root, write.path));
+        if (existing !== null) {
+            backupTargets.push(write.path);
+        }
+    }
+    for (const target of backupTargets) {
+        actions.push({
+            kind: "backup",
+            path: target,
+            action: "backup",
+            details: `Snapshot to ${path.posix.join(".harness/.backup", path.basename(backupRoot), target)}`,
+        });
+    }
+    if (dryRun) {
+        return {
+            success: true,
+            dryRun,
+            backupRoot,
+            actions,
+            diagnostics: [],
+        };
+    }
+    for (const target of backupTargets) {
+        await copyWorkspaceFileToBackup(paths, target, backupRoot);
+    }
+    const writeOrder = sortWriteOrder(pendingWrites);
+    for (const write of writeOrder) {
+        await writeFileAtomic(path.join(paths.root, write.path), write.content);
+    }
+    return {
+        success: true,
+        dryRun,
+        backupRoot,
+        actions,
+        diagnostics: [],
+    };
+}
+async function buildOverrideWrite(paths, file) {
+    const absolute = path.join(paths.root, file.path ?? "");
+    const text = await readTextIfExists(absolute);
+    if (text === null) {
+        return {
+            diagnostic: {
+                code: "OVERRIDE_MIGRATION_FAILED",
+                severity: "error",
+                message: `Missing override file '${file.path}'`,
+                path: file.path,
+            },
+        };
+    }
+    try {
+        const YAML = await import("yaml");
+        const parsed = YAML.parse(text);
+        const migrated = await migrateVersionedObject("provider-override", parsed);
+        const serialized = withSingleTrailingNewline(YAML.stringify(migrated));
+        const write = await maybeWrite(paths.root, "provider-override", file.path ?? "", serialized, "Override schema migrated");
+        return { write: write ?? undefined };
+    }
+    catch (error) {
+        return {
+            diagnostic: toMigrationErrorDiagnostic(error, file.path, "OVERRIDE_MIGRATION_FAILED", file.provider),
+        };
+    }
+}
+async function migrateVersionedObject(kind, input) {
+    const detected = detectDocumentVersion(kind, input);
+    if (detected.status !== "ok") {
+        throw new Error(`Cannot migrate ${kind}: missing or invalid version field`);
+    }
+    if (detected.version === undefined) {
+        throw new Error(`Cannot migrate ${kind}: missing version value`);
+    }
+    const targetVersion = LATEST_VERSION_BY_KIND[kind];
+    if (detected.version > targetVersion) {
+        throw new Error(`Cannot migrate ${kind} from newer version ${detected.version}`);
+    }
+    if (detected.version === targetVersion) {
+        return parseAsCurrent(kind, input);
+    }
+    const chain = resolveMigrationChain(defaultMigrationRegistry, kind, detected.version, targetVersion);
+    if (chain === null) {
+        // No migration chain available — fall back to bumping version and re-parsing.
+        if (!input || typeof input !== "object" || Array.isArray(input)) {
+            throw new Error(`Cannot migrate ${kind}: expected object document`);
+        }
+        const bumped = {
+            ...input,
+            version: targetVersion,
+        };
+        return parseAsCurrent(kind, bumped);
+    }
+    const migrated = await runMigrationChain(defaultMigrationRegistry, kind, detected.version, targetVersion, input);
+    return parseAsCurrent(kind, migrated.output);
+}
+function parseAsCurrent(kind, input) {
+    switch (kind) {
+        case "manifest":
+            return parseManifest(input);
+        case "provider-override":
+            return parseProviderOverride(input);
+        case "lock":
+            return input;
+        case "managed-index":
+            return input;
+    }
+}
+async function deriveLatestState(paths, manifest) {
+    const loaded = await loadCanonicalState(paths, manifest);
+    const firstPass = await buildPlan(paths, loaded, emptyManagedIndex(), null);
+    const blockingDiagnostics = firstPass.diagnostics.filter((diagnostic) => diagnostic.severity === "error" && diagnostic.code !== "OUTPUT_COLLISION_UNMANAGED");
+    if (blockingDiagnostics.length > 0) {
+        return {
+            lock: firstPass.nextLock,
+            managedIndex: firstPass.nextManagedIndex,
+            diagnostics: blockingDiagnostics,
+        };
+    }
+    const secondPass = await buildPlan(paths, loaded, {
+        version: LATEST_VERSION_BY_KIND["managed-index"],
+        managedSourcePaths: firstPass.nextManagedIndex.managedSourcePaths,
+        managedOutputPaths: firstPass.nextManagedIndex.managedOutputPaths,
+    }, null);
+    const secondBlocking = secondPass.diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+    return {
+        lock: secondPass.nextLock,
+        managedIndex: secondPass.nextManagedIndex,
+        diagnostics: secondBlocking,
+    };
+}
+async function maybeWrite(rootAbs, kind, relativePath, content, details) {
+    const absolute = path.join(rootAbs, relativePath);
+    const existing = await readTextIfExists(absolute);
+    if (existing === content) {
+        return null;
+    }
+    return {
+        kind,
+        path: relativePath,
+        content,
+        details,
+        action: kind === "provider-override" ? "migrate" : "rewrite",
+    };
+}
+function sortWriteOrder(writes) {
+    const order = {
+        "provider-override": 0,
+        lock: 1,
+        "managed-index": 2,
+        manifest: 3,
+    };
+    return [...writes].sort((left, right) => {
+        const byKind = order[left.kind] - order[right.kind];
+        if (byKind !== 0) {
+            return byKind;
+        }
+        return left.path.localeCompare(right.path);
+    });
+}
+function toMigrationErrorDiagnostic(error, pathValue, code, provider) {
+    return {
+        code,
+        severity: "error",
+        message: error instanceof Error ? error.message : "Migration failed",
+        path: pathValue,
+        provider,
+    };
+}
+function migrationTimestamp() {
+    return new Date().toISOString().replace(/[:.]/g, "-");
+}
+//# sourceMappingURL=migrate.js.map

package/dist/versioning/migrate.js.map

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

package/dist/versioning/registry.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentKind } from "@madebywild/agent-harness-manifest";
+export interface MigrationStep {
+    kind: DocumentKind;
+    fromVersion: number;
+    toVersion: number;
+    migrate(input: unknown): unknown | Promise<unknown>;
+}
+export interface MigrationRegistry {
+    readonly byKind: ReadonlyMap<DocumentKind, ReadonlyArray<MigrationStep>>;
+}
+export declare function createMigrationRegistry(steps: readonly MigrationStep[]): MigrationRegistry;
+export declare function resolveMigrationChain(registry: MigrationRegistry, kind: DocumentKind, fromVersion: number, toVersion: number): MigrationStep[] | null;
+export declare function runMigrationChain(registry: MigrationRegistry, kind: DocumentKind, fromVersion: number, toVersion: number, input: unknown): Promise<{
+    output: unknown;
+    appliedSteps: number;
+}>;
+export declare const defaultMigrationRegistry: MigrationRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/versioning/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/versioning/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;CAC1E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,iBAAiB,CAyB1F;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,aAAa,EAAE,GAAG,IAAI,CAiCxB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAepD;AAED,eAAO,MAAM,wBAAwB,mBAA8B,CAAC"}

package/dist/versioning/registry.js

@@ -0,0 +1,63 @@
+export function createMigrationRegistry(steps) {
+    const map = new Map();
+    for (const step of steps) {
+        const existing = map.get(step.kind) ?? [];
+        existing.push(step);
+        map.set(step.kind, existing);
+    }
+    for (const [kind, kindSteps] of map.entries()) {
+        map.set(kind, [...kindSteps].sort((left, right) => {
+            const byFrom = left.fromVersion - right.fromVersion;
+            if (byFrom !== 0) {
+                return byFrom;
+            }
+            return left.toVersion - right.toVersion;
+        }));
+    }
+    return {
+        byKind: map,
+    };
+}
+export function resolveMigrationChain(registry, kind, fromVersion, toVersion) {
+    if (fromVersion === toVersion) {
+        return [];
+    }
+    if (fromVersion > toVersion) {
+        return null;
+    }
+    const available = registry.byKind.get(kind) ?? [];
+    const chain = [];
+    let current = fromVersion;
+    while (current < toVersion) {
+        const next = available.find((step) => step.fromVersion === current);
+        if (!next) {
+            return null;
+        }
+        // Ensure the step advances the version and does not overshoot the target.
+        if (next.toVersion <= current || next.toVersion > toVersion) {
+            return null;
+        }
+        chain.push(next);
+        current = next.toVersion;
+    }
+    if (current !== toVersion) {
+        return null;
+    }
+    return chain;
+}
+export async function runMigrationChain(registry, kind, fromVersion, toVersion, input) {
+    const chain = resolveMigrationChain(registry, kind, fromVersion, toVersion);
+    if (chain === null) {
+        throw new Error(`No migration chain available for ${kind} ${fromVersion} -> ${toVersion}`);
+    }
+    let output = input;
+    for (const step of chain) {
+        output = await step.migrate(output);
+    }
+    return {
+        output,
+        appliedSteps: chain.length,
+    };
+}
+export const defaultMigrationRegistry = createMigrationRegistry([]);
+//# sourceMappingURL=registry.js.map

package/dist/versioning/registry.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@madebywild/agent-harness-framework",
+  "version": "0.9.1",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "harness": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@iarna/toml": "^2.2.5",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "gray-matter": "^4.0.3",
+    "ora": "^9.3.0",
+    "yaml": "^2.8.2",
+    "@madebywild/agent-harness-manifest": "0.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "testcontainers": "^11.13.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "pnpm exec tsc -b",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "lint": "biome lint .",
+    "lint:write": "biome lint --write .",
+    "format": "biome format .",
+    "format:write": "biome format --write .",
+    "check": "biome check .",
+    "check:write": "biome check --write .",
+    "test": "pnpm exec tsx --test test/*.test.ts",
+    "test:e2e:containers": "pnpm exec tsx --test test/e2e/**/*.e2e.test.ts",
+    "typecheck": "pnpm exec tsc -b --pretty false"
+  }
+}