@madebywild/agent-harness-framework 0.9.1

package/dist/utils.js

@@ -0,0 +1,115 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+export function sha256(value) {
+    return crypto.createHash("sha256").update(value, "utf8").digest("hex");
+}
+export function normalizeRelativePath(input) {
+    const posixInput = input.replace(/\\/g, "/");
+    if (/^[a-zA-Z]:/u.test(posixInput)) {
+        throw new Error(`invalid relative path '${input}'`);
+    }
+    if (posixInput.split("/").includes("..")) {
+        throw new Error(`invalid relative path '${input}'`);
+    }
+    const normalized = path.posix.normalize(posixInput);
+    const withoutDot = normalized.startsWith("./") ? normalized.slice(2) : normalized;
+    if (!withoutDot ||
+        withoutDot === "." ||
+        withoutDot === ".." ||
+        withoutDot.startsWith("/") ||
+        withoutDot.split("/").includes("..")) {
+        throw new Error(`invalid relative path '${input}'`);
+    }
+    return withoutDot;
+}
+export function toPosixRelative(fromAbs, rootAbs) {
+    const relative = path.relative(rootAbs, fromAbs).replace(/\\/g, "/");
+    return normalizeRelativePath(relative);
+}
+export function stableStringify(value) {
+    return `${JSON.stringify(sortJsonValue(value), undefined, 2)}\n`;
+}
+function sortJsonValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => sortJsonValue(entry));
+    }
+    if (value && typeof value === "object") {
+        const objectValue = value;
+        const sortedEntries = Object.entries(objectValue)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nestedValue]) => [key, sortJsonValue(nestedValue)]);
+        return Object.fromEntries(sortedEntries);
+    }
+    return value;
+}
+export async function readTextIfExists(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNotFoundError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function exists(filePath) {
+    try {
+        await fs.stat(filePath);
+        return true;
+    }
+    catch (error) {
+        if (isNotFoundError(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function ensureParentDir(filePath) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+}
+export async function writeFileAtomic(absPath, content) {
+    await ensureParentDir(absPath);
+    const tempPath = path.join(path.dirname(absPath), `.${path.basename(absPath)}.${process.pid}.${crypto.randomUUID()}.tmp`);
+    await fs.writeFile(tempPath, content, "utf8");
+    try {
+        await fs.rename(tempPath, absPath);
+    }
+    catch (error) {
+        await fs.rm(tempPath, { force: true }).catch(() => {
+            // best effort cleanup for failed atomic writes
+        });
+        throw error;
+    }
+}
+export async function copyToBackup(rootAbs, relPath, backupRootAbs) {
+    const normalized = normalizeRelativePath(relPath);
+    const sourceAbs = path.join(rootAbs, normalized);
+    if (!(await exists(sourceAbs))) {
+        return false;
+    }
+    const backupAbs = path.join(backupRootAbs, normalized);
+    await ensureParentDir(backupAbs);
+    await fs.copyFile(sourceAbs, backupAbs);
+    return true;
+}
+export function isNotFoundError(error) {
+    return (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT");
+}
+export function deepEqual(left, right) {
+    return JSON.stringify(sortJsonValue(left)) === JSON.stringify(sortJsonValue(right));
+}
+export function uniqSorted(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function stripTrailingNewlines(value) {
+    return value.replace(/[\n\r]+$/g, "");
+}
+export function withSingleTrailingNewline(value) {
+    return `${stripTrailingNewlines(value)}\n`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAClF,IACE,CAAC,UAAU;QACX,UAAU,KAAK,GAAG;QAClB,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAC1B,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACpC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,OAAe;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrE,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,KAAgC,CAAC;QACrD,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;aAC9C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,WAAW,CAAC,CAAU,CAAC,CAAC;QAC3E,OAAO,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe,EAAE,OAAe;IACpE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,MAAM,CACvE,CAAC;IAEF,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAChD,+CAA+C;QACjD,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,OAAe,EAAE,aAAqB;IACxF,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEjD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACvD,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ,CACjH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,KAAc;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/versioning/doctor.d.ts

@@ -0,0 +1,6 @@
+import type { HarnessPaths } from "../paths.js";
+import type { Diagnostic, DoctorResult } from "../types.js";
+export declare function runDoctor(paths: HarnessPaths): Promise<DoctorResult>;
+export declare function hasVersionBlockers(doctor: DoctorResult): boolean;
+export declare function buildVersionPreflightDiagnostics(doctor: DoctorResult): Diagnostic[];
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/versioning/doctor.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAgD,MAAM,aAAa,CAAC;AAK1G,wBAAsB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAqG1E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,EAAE,CAYnF"}

package/dist/versioning/doctor.js

@@ -0,0 +1,284 @@
+import path from "node:path";
+import { detectDocumentVersion, LATEST_VERSION_BY_KIND, parseManagedIndex, parseManifest, parseManifestLock, parseProviderOverride, providerIdSchema, VersionError, } from "@madebywild/agent-harness-manifest";
+import { collectSourceCandidates } from "../repository.js";
+import { readTextIfExists } from "../utils.js";
+const OVERRIDE_PROVIDER_PATTERN = /(?:\.overrides\.|OVERRIDES\.)(codex|claude|copilot)\.ya?ml$/u;
+export async function runDoctor(paths) {
+    const files = [];
+    const manifestStatus = await inspectJsonDocument(paths, {
+        kind: "manifest",
+        relativePath: ".harness/manifest.json",
+        required: true,
+        parseCurrent: parseManifest,
+        invalidCode: "MANIFEST_INVALID",
+    });
+    if (manifestStatus) {
+        files.push(manifestStatus);
+    }
+    const lockStatus = await inspectJsonDocument(paths, {
+        kind: "lock",
+        relativePath: ".harness/manifest.lock.json",
+        required: false,
+        parseCurrent: parseManifestLock,
+        invalidCode: "LOCK_INVALID",
+    });
+    if (lockStatus) {
+        files.push(lockStatus);
+    }
+    const managedIndexStatus = await inspectJsonDocument(paths, {
+        kind: "managed-index",
+        relativePath: ".harness/managed-index.json",
+        required: false,
+        parseCurrent: parseManagedIndex,
+        invalidCode: "MANAGED_INDEX_INVALID",
+    });
+    if (managedIndexStatus) {
+        files.push(managedIndexStatus);
+    }
+    const sourceCandidates = await collectSourceCandidates(paths);
+    const overrideCandidates = sourceCandidates.filter((candidate) => OVERRIDE_PROVIDER_PATTERN.test(candidate));
+    for (const overridePath of overrideCandidates) {
+        const provider = parseProviderFromOverridePath(overridePath);
+        const absolute = path.join(paths.root, overridePath);
+        const text = await readTextIfExists(absolute);
+        if (text === null) {
+            continue;
+        }
+        try {
+            const YAML = await import("yaml");
+            const parsed = YAML.parse(text);
+            files.push(inspectParsedVersionedObject("provider-override", overridePath, parsed, parseProviderOverride, provider));
+        }
+        catch (error) {
+            files.push({
+                code: "OVERRIDE_INVALID",
+                severity: "error",
+                message: error instanceof Error ? error.message : "Invalid override YAML",
+                path: overridePath,
+                provider,
+                kind: "provider-override",
+                status: "invalid",
+                latestVersion: LATEST_VERSION_BY_KIND["provider-override"],
+                canMigrate: false,
+                hint: "Fix override YAML/schema issues before running 'harness migrate'.",
+            });
+        }
+    }
+    const diagnostics = files
+        .filter((status) => status.status !== "current")
+        .map((status) => ({
+        code: status.code,
+        severity: status.severity,
+        message: status.message,
+        hint: status.hint,
+        path: status.path,
+        provider: status.provider,
+    }));
+    const migrationNeeded = files.some((status) => status.status === "outdated");
+    const hasBlockingState = files.some((status) => ["unsupported", "invalid", "missing"].includes(status.status));
+    if (migrationNeeded && files.some((status) => status.status === "current")) {
+        diagnostics.push({
+            code: "MIGRATION_INCOMPLETE",
+            severity: "error",
+            message: "Workspace contains mixed schema versions. Rerun 'harness migrate' to converge to latest schema.",
+            path: ".harness",
+            hint: "Run 'harness migrate' again. If it fails, inspect diagnostics and fix blocking files first.",
+        });
+    }
+    return {
+        healthy: files.length > 0 && diagnostics.length === 0,
+        migrationNeeded,
+        migrationPossible: !hasBlockingState,
+        files,
+        diagnostics,
+    };
+}
+export function hasVersionBlockers(doctor) {
+    return doctor.files.some((status) => status.status !== "current");
+}
+export function buildVersionPreflightDiagnostics(doctor) {
+    return doctor.diagnostics.length > 0
+        ? doctor.diagnostics
+        : [
+            {
+                code: "WORKSPACE_VERSION_BLOCKED",
+                severity: "error",
+                message: "Workspace schema version is not compatible with this CLI runtime.",
+                hint: "Run 'harness doctor' then 'harness migrate'.",
+                path: ".harness",
+            },
+        ];
+}
+async function inspectJsonDocument(paths, input) {
+    const absolute = path.join(paths.root, input.relativePath);
+    const text = await readTextIfExists(absolute);
+    if (text === null) {
+        if (!input.required) {
+            return null;
+        }
+        const isDefaultManifest = input.kind === "manifest" && input.relativePath === ".harness/manifest.json";
+        return {
+            code: isDefaultManifest ? "MANIFEST_NOT_FOUND" : "DOCUMENT_NOT_FOUND",
+            severity: "error",
+            message: isDefaultManifest
+                ? "Missing manifest file at .harness/manifest.json"
+                : `Missing required ${input.kind} file at ${input.relativePath}`,
+            path: input.relativePath,
+            hint: isDefaultManifest ? "Run 'harness init' first." : undefined,
+            kind: input.kind,
+            status: "missing",
+            latestVersion: LATEST_VERSION_BY_KIND[input.kind],
+            canMigrate: false,
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        return {
+            code: input.invalidCode,
+            severity: "error",
+            message: error instanceof Error ? error.message : "Invalid JSON",
+            path: input.relativePath,
+            kind: input.kind,
+            status: "invalid",
+            latestVersion: LATEST_VERSION_BY_KIND[input.kind],
+            canMigrate: false,
+            hint: "Fix schema/JSON issues before running 'harness migrate'.",
+        };
+    }
+    return inspectParsedVersionedObject(input.kind, input.relativePath, parsed, input.parseCurrent);
+}
+function inspectParsedVersionedObject(kind, pathValue, parsed, parseCurrent, provider) {
+    const detection = detectDocumentVersion(kind, parsed);
+    if (detection.status === "missing") {
+        return createVersionStatus(kind, pathValue, {
+            status: "missing",
+            code: versionCode(kind, "MISSING"),
+            message: "Missing required numeric 'version' field",
+            provider,
+            canMigrate: false,
+            hint: "Add a valid numeric 'version' field and rerun 'harness doctor'.",
+        });
+    }
+    if (detection.status === "invalid_type") {
+        return createVersionStatus(kind, pathValue, {
+            status: "invalid",
+            code: versionCode(kind, "INVALID"),
+            message: "Version field must be an integer",
+            provider,
+            canMigrate: false,
+            hint: "Set 'version' to an integer value before running 'harness migrate'.",
+        });
+    }
+    const version = detection.version;
+    if (version < detection.latestVersion) {
+        return createVersionStatus(kind, pathValue, {
+            status: "outdated",
+            version,
+            code: versionCode(kind, "OUTDATED"),
+            message: `Detected version ${version}; latest supported version is ${detection.latestVersion}`,
+            provider,
+            canMigrate: true,
+            hint: "Run 'harness migrate' to upgrade this file.",
+        });
+    }
+    if (version > detection.latestVersion) {
+        return createVersionStatus(kind, pathValue, {
+            status: "unsupported",
+            version,
+            code: versionCode(kind, "NEWER_THAN_CLI"),
+            message: `Detected version ${version}, which is newer than this CLI supports (${detection.latestVersion})`,
+            provider,
+            canMigrate: false,
+            hint: "Install a newer harness CLI for this workspace.",
+        });
+    }
+    try {
+        parseCurrent(parsed);
+        return createVersionStatus(kind, pathValue, {
+            status: "current",
+            version,
+            code: versionCode(kind, "CURRENT"),
+            message: `Version ${version} is current`,
+            provider,
+            canMigrate: true,
+        });
+    }
+    catch (error) {
+        if (error instanceof VersionError) {
+            return createVersionStatus(kind, pathValue, {
+                status: statusFromVersionError(error),
+                code: versionCode(kind, codeFromVersionError(error)),
+                message: error.message,
+                provider,
+                canMigrate: false,
+                hint: "Resolve version issues before running migration.",
+            });
+        }
+        return createVersionStatus(kind, pathValue, {
+            status: "invalid",
+            version,
+            code: kind === "manifest" ? "MANIFEST_INVALID" : kind === "lock" ? "LOCK_INVALID" : "MANAGED_INDEX_INVALID",
+            message: error instanceof Error ? error.message : "Invalid schema",
+            provider,
+            canMigrate: false,
+            hint: "Fix schema validation issues before running migration.",
+        });
+    }
+}
+function createVersionStatus(kind, pathValue, input) {
+    return {
+        code: input.code,
+        severity: input.status === "current" ? "info" : "error",
+        message: input.message,
+        path: pathValue,
+        provider: input.provider,
+        kind,
+        status: input.status,
+        version: input.version,
+        latestVersion: LATEST_VERSION_BY_KIND[kind],
+        canMigrate: input.canMigrate,
+        hint: input.hint,
+    };
+}
+function versionCode(kind, suffix) {
+    if (kind === "provider-override") {
+        return `OVERRIDE_VERSION_${suffix}`;
+    }
+    return `${kind.toUpperCase().replaceAll("-", "_")}_VERSION_${suffix}`;
+}
+function parseProviderFromOverridePath(pathValue) {
+    const match = pathValue.match(OVERRIDE_PROVIDER_PATTERN);
+    if (!match?.[1]) {
+        return undefined;
+    }
+    const parsed = providerIdSchema.safeParse(match[1]);
+    return parsed.success ? parsed.data : undefined;
+}
+function statusFromVersionError(error) {
+    switch (error.reason) {
+        case "outdated_version":
+            return "outdated";
+        case "unsupported_version":
+            return "unsupported";
+        case "missing_version":
+            return "missing";
+        case "invalid_version_type":
+            return "invalid";
+    }
+}
+function codeFromVersionError(error) {
+    switch (error.reason) {
+        case "outdated_version":
+            return "OUTDATED";
+        case "unsupported_version":
+            return "NEWER_THAN_CLI";
+        case "missing_version":
+            return "MISSING";
+        case "invalid_version_type":
+            return "INVALID";
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/versioning/doctor.js.map

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

package/dist/versioning/migrate.d.ts

@@ -0,0 +1,9 @@
+import type { HarnessPaths } from "../paths.js";
+import type { MigrationResult } from "../types.js";
+interface MigrateWorkspaceOptions {
+    to?: "latest";
+    dryRun?: boolean;
+}
+export declare function runMigration(paths: HarnessPaths, options?: MigrateWorkspaceOptions): Promise<MigrationResult>;
+export {};
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/versioning/migrate.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAKV,eAAe,EAGhB,MAAM,aAAa,CAAC;AAKrB,UAAU,uBAAuB;IAC/B,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD,wBAAsB,YAAY,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,CAAC,CAkQ1B"}