@monoes/monomindcli 2.9.25 → 2.9.27

package/dist/src/platform-adapters/merge.js

@@ -0,0 +1,209 @@
+/** Safe, format-neutral primitives for Monomind-managed configuration content. */
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function isValidMarker(marker) {
+    return marker.trim().length > 0 && marker.trim() === marker && !/[\r\n]/.test(marker);
+}
+function markerBlockPattern(marker) {
+    if (!isValidMarker(marker))
+        return undefined;
+    const escapedMarker = escapeRegExp(marker);
+    const commentPrefix = '(?:(?:#|//)\\s*|<!--\\s*)?';
+    const suffix = '\\s*(?:-->)?[^\\S\\r\\n]*(?:\\r?\\n|$)';
+    return new RegExp(`^[\\t ]*${commentPrefix}monomind:start\\s+${escapedMarker}${suffix}[\\s\\S]*?^[\\t ]*${commentPrefix}monomind:end\\s+${escapedMarker}${suffix}`, 'gm');
+}
+function lineEnding(content) {
+    return content.includes('\r\n') ? '\r\n' : '\n';
+}
+function managedBlock(marker, content, eol, comment) {
+    const body = content.replace(/\r\n|\r|\n/g, eol).replace(new RegExp(`(?:${eol})+$`), '');
+    const start = `${comment} monomind:start ${marker}`;
+    const end = `${comment} monomind:end ${marker}`;
+    return body.length > 0 ? `${start}${eol}${body}${eol}${end}${eol}` : `${start}${eol}${end}${eol}`;
+}
+/**
+ * Adds or replaces one managed marker block. Blocks for other artifacts and
+ * platforms are deliberately left untouched.
+ */
+export function mergeManagedBlock(existing, marker, content, comment = '#') {
+    const pattern = markerBlockPattern(marker);
+    if (!pattern)
+        return existing;
+    const block = managedBlock(marker, content, lineEnding(existing), comment);
+    let found = false;
+    const merged = existing.replace(pattern, () => {
+        if (found)
+            return '';
+        found = true;
+        return block;
+    });
+    if (found)
+        return merged;
+    return existing.length === 0 || /(?:\r?\n)$/.test(existing)
+        ? `${existing}${block}`
+        : `${existing}${lineEnding(existing)}${block}`;
+}
+/** Removes exactly one artifact/platform block, leaving all other content unchanged. */
+export function removeManagedBlock(content, artifact, platform) {
+    return removeManagedMarker(content, `${artifact}:${platform}`);
+}
+/** Removes a block by its full marker for artifacts with qualified names. */
+export function removeManagedMarker(content, marker) {
+    const pattern = markerBlockPattern(marker);
+    return pattern ? content.replace(pattern, '') : content;
+}
+function frontmatterEnd(content) {
+    if (!content.startsWith('---\n'))
+        return undefined;
+    const end = content.indexOf('\n---\n', 4);
+    return end === -1 ? undefined : end + '\n---\n'.length;
+}
+function skillName(content) {
+    const end = frontmatterEnd(content);
+    if (end === undefined)
+        return undefined;
+    return /^name:\s*([^\s]+)\s*$/m.exec(content.slice(0, end))?.[1];
+}
+/**
+ * SKILL.md requires YAML frontmatter to be its first bytes. Keep it outside
+ * the managed marker and replace only Monomind's body block. A same-name file
+ * may contain user guidance around the block; a different-name file is foreign
+ * and is never overwritten by an adapter install.
+ */
+export function mergeSkillManagedBlock(existing, marker, rendered) {
+    const renderedEnd = frontmatterEnd(rendered);
+    const name = skillName(rendered);
+    if (renderedEnd === undefined || !name)
+        return { content: existing, diagnostics: ['ERROR: rendered skill has invalid frontmatter'] };
+    if (!existing) {
+        const header = rendered.slice(0, renderedEnd);
+        const body = rendered.slice(renderedEnd).replace(/^\n/, '');
+        return { content: `${header}${mergeManagedBlock('', marker, body)}`, diagnostics: [] };
+    }
+    const existingEnd = frontmatterEnd(existing);
+    if (existingEnd === undefined || skillName(existing) !== name) {
+        return {
+            content: existing,
+            diagnostics: [`ERROR: foreign SKILL.md prevents installing ${name}`],
+        };
+    }
+    const header = existing.slice(0, existingEnd);
+    const body = existing.slice(existingEnd);
+    const renderedBody = rendered.slice(renderedEnd).replace(/^\n/, '');
+    return { content: `${header}${mergeManagedBlock(body, marker, renderedBody)}`, diagnostics: [] };
+}
+function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseJsonObject(content) {
+    try {
+        const parsed = JSON.parse(content);
+        if (isJsonObject(parsed))
+            return { value: parsed };
+        return { content, diagnostics: ['ERROR: expected a JSON object at the document root'] };
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return { content, diagnostics: [`ERROR: invalid JSON: ${detail}`] };
+    }
+}
+function isSafeJsonResult(value) {
+    return !('value' in value);
+}
+function validatePath(path) {
+    if (path.length === 0)
+        return 'ERROR: named-entry path must contain an entry name';
+    if (path.some((segment) => segment.trim().length === 0))
+        return 'ERROR: named-entry path segments must not be empty';
+    return undefined;
+}
+function jsonIndent(content) {
+    const indentation = content.match(/\r?\n([\t ]+)"/u)?.[1];
+    if (!indentation)
+        return undefined;
+    return indentation.includes('\t') ? '\t' : indentation.length;
+}
+function stringifyJson(value, source) {
+    const rendered = JSON.stringify(value, null, jsonIndent(source));
+    return source.endsWith('\n') ? `${rendered}${lineEnding(source)}` : rendered;
+}
+function normalizeJsonValue(value) {
+    try {
+        const serialized = JSON.stringify(value);
+        if (serialized === undefined)
+            return { ok: false, diagnostic: 'ERROR: named-entry value is not JSON serializable' };
+        return { ok: true, value: JSON.parse(serialized) };
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return {
+            ok: false,
+            diagnostic: `ERROR: named-entry value is not JSON serializable: ${detail}`,
+        };
+    }
+}
+function sameJsonValue(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+function parentForEntry(root, path, createMissing) {
+    let current = root;
+    for (const segment of path) {
+        const child = current[segment];
+        if (child === undefined && createMissing) {
+            const created = {};
+            current[segment] = created;
+            current = created;
+            continue;
+        }
+        if (!isJsonObject(child))
+            return `ERROR: JSON path segment "${segment}" is not an object`;
+        current = child;
+    }
+    return current;
+}
+/** Merges a named JSON object entry, leaving malformed input unmodified. */
+export function safeJsonMerge(content, path, entry) {
+    const pathError = validatePath(path);
+    if (pathError)
+        return { content, diagnostics: [pathError] };
+    const parsed = parseJsonObject(content);
+    if (isSafeJsonResult(parsed))
+        return parsed;
+    const normalizedEntry = normalizeJsonValue(entry);
+    if (!normalizedEntry.ok)
+        return { content, diagnostics: [normalizedEntry.diagnostic] };
+    const parent = parentForEntry(parsed.value, path.slice(0, -1), true);
+    if (typeof parent === 'string')
+        return { content, diagnostics: [parent] };
+    const name = path[path.length - 1];
+    if (sameJsonValue(parent[name], normalizedEntry.value))
+        return { content, diagnostics: [] };
+    parent[name] = normalizedEntry.value;
+    return { content: stringifyJson(parsed.value, content), diagnostics: [] };
+}
+/** Convenience form for callers that do not need malformed-input diagnostics. */
+export function mergeNamedEntry(content, path, entry) {
+    return safeJsonMerge(content, path, entry).content;
+}
+/** Removes a named JSON object entry, leaving malformed input unmodified. */
+export function safeJsonRemove(content, path, name) {
+    const pathError = validatePath([...path, name]);
+    if (pathError)
+        return { content, diagnostics: [pathError] };
+    const parsed = parseJsonObject(content);
+    if (isSafeJsonResult(parsed))
+        return parsed;
+    const parent = parentForEntry(parsed.value, path, false);
+    if (typeof parent === 'string')
+        return { content, diagnostics: [parent] };
+    if (!(name in parent))
+        return { content, diagnostics: [] };
+    delete parent[name];
+    return { content: stringifyJson(parsed.value, content), diagnostics: [] };
+}
+/** Convenience form for callers that do not need malformed-input diagnostics. */
+export function removeNamedEntry(content, path, name) {
+    return safeJsonRemove(content, path, name).content;
+}
+//# sourceMappingURL=merge.js.map

package/dist/src/platform-adapters/merge.js.map

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

package/dist/src/platform-adapters/migration.d.ts

@@ -0,0 +1,31 @@
+/** Detection and safe cleanup rules for pre-adapter platform installations. */
+export interface LegacySurface {
+    id: string;
+    path: string;
+    scope: 'project' | 'user';
+    ownership: 'marker' | 'named-entry' | 'monomind-file';
+    action: 'remove-block' | 'remove-entry' | 'remove-file' | 'migrate';
+}
+export interface LegacyMigrationResult {
+    changed: readonly string[];
+    skipped: readonly string[];
+    diagnostics: readonly string[];
+}
+/**
+ * Every surface is explicit so detection can remain read-only and never infer
+ * ownership from an arbitrary file name or config location.
+ */
+export declare const LEGACY_SURFACE_INVENTORY: readonly LegacySurface[];
+export declare function isMonomindOwned(content: string): boolean;
+export declare function findLegacySurfaces(root: string, scope: 'project' | 'user'): string[];
+/** Remove only old marker blocks; callers retain unrelated content and keys. */
+export declare function removeLegacyManagedBlocks(content: string): string;
+/** Recover a YAML file corrupted by the historical HTML comment installer. */
+export declare function deCorruptAiderYaml(content: string): string;
+export declare function migrateLegacyArtifacts(root: string, scope: 'project' | 'user', options?: {
+    dryRun?: boolean;
+    removeLegacy?: boolean;
+    /** Called before a verified legacy artifact is changed or removed. */
+    beforeWrite?: (path: string) => void;
+}): LegacyMigrationResult;
+//# sourceMappingURL=migration.d.ts.map

package/dist/src/platform-adapters/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../../src/platform-adapters/migration.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAc/E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,SAAS,EAAE,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;IACtD,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,aAAa,GAAG,SAAS,CAAC;CACrE;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,aAAa,EA2J3D,CAAC;AAEH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAapF;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1D;AA4GD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GACL,qBAAqB,CAgHvB"}

package/dist/src/platform-adapters/migration.js

@@ -0,0 +1,402 @@
+/** Detection and safe cleanup rules for pre-adapter platform installations. */
+import { existsSync, mkdirSync, readFileSync, rmSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { mergeManagedBlock, removeManagedMarker } from './merge.js';
+/**
+ * Every surface is explicit so detection can remain read-only and never infer
+ * ownership from an arbitrary file name or config location.
+ */
+export const LEGACY_SURFACE_INVENTORY = Object.freeze([
+    {
+        id: 'codex-sessionstart',
+        path: '.codex/config.toml',
+        scope: 'user',
+        ownership: 'marker',
+        action: 'remove-block',
+    },
+    {
+        id: 'codex-activate-script',
+        path: '.codex/monomind-activate.cjs',
+        scope: 'user',
+        ownership: 'monomind-file',
+        action: 'remove-file',
+    },
+    {
+        id: 'cursor-sessionstart',
+        path: '.cursor/settings.json',
+        scope: 'project',
+        ownership: 'named-entry',
+        action: 'remove-entry',
+    },
+    {
+        id: 'cursor-activate-script',
+        path: '.cursor/monomind-activate.cjs',
+        scope: 'user',
+        ownership: 'monomind-file',
+        action: 'remove-file',
+    },
+    {
+        id: 'antigravity-plugin',
+        path: '.gemini/antigravity-cli/plugins/monomind',
+        scope: 'user',
+        ownership: 'monomind-file',
+        action: 'remove-file',
+    },
+    {
+        id: 'shared-agent-skills',
+        path: '.agents/skills',
+        scope: 'project',
+        ownership: 'monomind-file',
+        action: 'remove-file',
+    },
+    {
+        id: 'shared-gemini-skills',
+        path: '.gemini/skills',
+        scope: 'user',
+        ownership: 'monomind-file',
+        action: 'remove-file',
+    },
+    {
+        id: 'openclaw-config',
+        path: '.claw/config.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'cursor-rules',
+        path: '.cursorrules',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'remove-block',
+    },
+    {
+        id: 'droid-instructions',
+        path: 'DROID.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'remove-block',
+    },
+    {
+        id: 'antigravity-rules',
+        path: '.agents/rules/monomind.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'remove-block',
+    },
+    {
+        id: 'trae-rules',
+        path: '.trae/rules/monomind.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'hermes-instructions',
+        path: 'HERMES.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'remove-block',
+    },
+    {
+        id: 'kiro-steering',
+        path: '.kiro/steering/monomind.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'aider-corrupted-yaml',
+        path: '.aider.conf.yml',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'bare-instruction-markers',
+        path: 'AGENTS.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'claude-bare-instruction-markers',
+        path: 'CLAUDE.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'gemini-bare-instruction-markers',
+        path: 'GEMINI.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'copilot-bare-instruction-markers',
+        path: '.github/copilot-instructions.md',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'cursor-bare-instruction-markers',
+        path: '.cursor/rules/monomind.mdc',
+        scope: 'project',
+        ownership: 'marker',
+        action: 'migrate',
+    },
+    {
+        id: 'claude-global-instructions',
+        path: '.claude/CLAUDE.md',
+        scope: 'user',
+        ownership: 'marker',
+        action: 'remove-block',
+    },
+    {
+        id: 'claude-global-sessionstart',
+        path: '.claude/settings.json',
+        scope: 'user',
+        ownership: 'named-entry',
+        action: 'remove-entry',
+    },
+]);
+export function isMonomindOwned(content) {
+    return /(?:<!--\s*)?monomind:start|monomind-activate|name:\s*mastermind(?:-|$)/i.test(content);
+}
+export function findLegacySurfaces(root, scope) {
+    return LEGACY_SURFACE_INVENTORY.filter((surface) => surface.scope === scope)
+        .filter((surface) => {
+        const path = join(root, surface.path);
+        if (!existsSync(path))
+            return false;
+        if (surface.ownership === 'monomind-file')
+            return true;
+        try {
+            return isMonomindOwned(readFileSync(path, 'utf8'));
+        }
+        catch {
+            return false;
+        }
+    })
+        .map((surface) => surface.id);
+}
+/** Remove only old marker blocks; callers retain unrelated content and keys. */
+export function removeLegacyManagedBlocks(content) {
+    return removeManagedMarker(removeManagedMarker(content, 'instructions:codex'), 'instructions:opencode')
+        .replace(/\n?<!--\s*monomind:start\s*-->[\s\S]*?<!--\s*monomind:end\s*-->\n?/g, '\n')
+        .replace(/\n?#\s*monomind:start\s*[\s\S]*?#\s*monomind:end\s*\n?/g, '\n');
+}
+/** Recover a YAML file corrupted by the historical HTML comment installer. */
+export function deCorruptAiderYaml(content) {
+    const cleaned = content
+        .replace(/\n?<!--\s*monomind:start\s*-->[\s\S]*?<!--\s*monomind:end\s*-->\n?/g, '\n')
+        .trimEnd();
+    if (/^read:\s*/m.test(cleaned))
+        return `${cleaned}\n`;
+    return `${cleaned ? `${cleaned}\n` : ''}read: CONVENTIONS.md\n`;
+}
+const BARE_BLOCK = /(?:<!--\s*)?monomind:start\s*-->(?:\r?\n)?([\s\S]*?)(?:<!--\s*)?monomind:end\s*-->(?:\r?\n)?/i;
+const HASH_BARE_BLOCK = /#\s*monomind:start\s*(?:\r?\n)?([\s\S]*?)#\s*monomind:end\s*(?:\r?\n)?/i;
+function takeLegacyBlock(content) {
+    const match = BARE_BLOCK.exec(content) ?? HASH_BARE_BLOCK.exec(content);
+    if (!match)
+        return undefined;
+    return {
+        body: match[1].trim(),
+        remainder: `${content.slice(0, match.index)}${content.slice(match.index + match[0].length)}`,
+    };
+}
+function instructionMarker(surface, body) {
+    switch (surface.id) {
+        case 'trae-rules':
+            return 'instructions:trae';
+        case 'kiro-steering':
+            return 'instructions:kiro';
+        case 'claude-bare-instruction-markers':
+            return 'instructions:claude';
+        case 'gemini-bare-instruction-markers':
+            return 'instructions:gemini';
+        case 'copilot-bare-instruction-markers':
+            return 'instructions:copilot';
+        case 'cursor-bare-instruction-markers':
+            return 'instructions:cursor';
+        case 'bare-instruction-markers':
+            // AGENTS.md is shared by several runtimes. Old installs did not retain
+            // their writer id, so use only an explicit self-identification; the
+            // conservative Codex fallback matches the legacy Codex writer.
+            if (/\bopencode\b/i.test(body))
+                return 'instructions:opencode';
+            if (/\bdroid\b/i.test(body))
+                return 'instructions:droid';
+            if (/\bopenclaw\b/i.test(body))
+                return 'instructions:openclaw';
+            if (/\bkimi\b/i.test(body))
+                return 'instructions:kimi';
+            return 'instructions:codex';
+        default:
+            return undefined;
+    }
+}
+function writeMigratedInstructions(root, surface, original, beforeWrite) {
+    const extracted = takeLegacyBlock(original);
+    if (!extracted)
+        return { changed: false, paths: [] };
+    if (surface.id === 'openclaw-config') {
+        const target = join(root, 'AGENTS.md');
+        const targetContent = existsSync(target) ? readFileSync(target, 'utf8') : '';
+        const migrated = mergeManagedBlock(targetContent, 'instructions:openclaw', extracted.body);
+        beforeWrite?.(target);
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, migrated, 'utf8');
+        beforeWrite?.(join(root, surface.path));
+        writeFileSync(join(root, surface.path), extracted.remainder, 'utf8');
+        return { changed: true, paths: ['AGENTS.md', surface.path] };
+    }
+    const marker = instructionMarker(surface, extracted.body);
+    if (!marker)
+        return { changed: false, paths: [] };
+    const migrated = mergeManagedBlock(extracted.remainder, marker, extracted.body);
+    beforeWrite?.(join(root, surface.path));
+    writeFileSync(join(root, surface.path), migrated, 'utf8');
+    return { changed: true, paths: [surface.path] };
+}
+function isOwnedScript(path) {
+    try {
+        return /monomind|mastermind/i.test(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
+function removeLegacyCursorHook(content) {
+    try {
+        const parsed = JSON.parse(content);
+        const hooks = parsed.hooks;
+        if (!hooks || typeof hooks !== 'object' || Array.isArray(hooks))
+            return { content, changed: false };
+        const entries = hooks.SessionStart;
+        if (!Array.isArray(entries))
+            return { content, changed: false };
+        const retained = entries.filter((entry) => !JSON.stringify(entry).includes('monomind-activate'));
+        if (retained.length === entries.length)
+            return { content, changed: false };
+        hooks.SessionStart = retained;
+        return { content: `${JSON.stringify(parsed, null, 2)}\n`, changed: true };
+    }
+    catch {
+        return {
+            content,
+            changed: false,
+            diagnostic: 'ERROR: cursor legacy settings are malformed; left unchanged',
+        };
+    }
+}
+export function migrateLegacyArtifacts(root, scope, options = {}) {
+    const changed = [];
+    const skipped = [];
+    const diagnostics = [];
+    for (const surface of LEGACY_SURFACE_INVENTORY.filter((item) => item.scope === scope)) {
+        const path = join(root, surface.path);
+        if (!existsSync(path)) {
+            skipped.push(surface.path);
+            continue;
+        }
+        if (surface.id === 'shared-agent-skills' || surface.id === 'shared-gemini-skills') {
+            // The current manifest has no consumer-reference record. Preserve the
+            // shared root and every package until one exists instead of guessing
+            // whether another adapter still owns it.
+            skipped.push(surface.path);
+            continue;
+        }
+        if (surface.ownership === 'monomind-file') {
+            if (statSync(path).isDirectory()) {
+                const manifest = join(path, 'plugin.json');
+                if (!existsSync(manifest) || !isOwnedScript(manifest)) {
+                    skipped.push(surface.path);
+                    continue;
+                }
+                if (!options.dryRun) {
+                    options.beforeWrite?.(path);
+                    rmSync(path, { recursive: true, force: false });
+                }
+            }
+            else {
+                if (!isOwnedScript(path)) {
+                    skipped.push(surface.path);
+                    continue;
+                }
+                if (!options.dryRun) {
+                    options.beforeWrite?.(path);
+                    unlinkSync(path);
+                }
+            }
+            changed.push(surface.path);
+            continue;
+        }
+        const original = readFileSync(path, 'utf8');
+        if (!isMonomindOwned(original)) {
+            skipped.push(surface.path);
+            continue;
+        }
+        if (surface.id === 'cursor-sessionstart' || surface.id === 'claude-global-sessionstart') {
+            const cursor = removeLegacyCursorHook(original);
+            if (cursor.diagnostic)
+                diagnostics.push(cursor.diagnostic);
+            if (!cursor.changed) {
+                skipped.push(surface.path);
+                continue;
+            }
+            if (!options.dryRun) {
+                options.beforeWrite?.(path);
+                writeFileSync(path, cursor.content, 'utf8');
+            }
+            changed.push(surface.path);
+            continue;
+        }
+        if (surface.id === 'aider-corrupted-yaml') {
+            const next = deCorruptAiderYaml(original);
+            if (next === original) {
+                skipped.push(surface.path);
+                continue;
+            }
+            if (!options.dryRun) {
+                options.beforeWrite?.(path);
+                writeFileSync(path, next, 'utf8');
+            }
+            changed.push(surface.path);
+            continue;
+        }
+        if (surface.action === 'migrate') {
+            if (options.dryRun) {
+                const extracted = takeLegacyBlock(original);
+                if (!extracted) {
+                    skipped.push(surface.path);
+                    continue;
+                }
+                changed.push(surface.path);
+                continue;
+            }
+            const migrated = writeMigratedInstructions(root, surface, original, options.beforeWrite);
+            if (!migrated.changed) {
+                skipped.push(surface.path);
+                continue;
+            }
+            changed.push(...migrated.paths);
+            continue;
+        }
+        const next = removeLegacyManagedBlocks(original);
+        if (next === original) {
+            skipped.push(surface.path);
+            continue;
+        }
+        if (!options.dryRun) {
+            options.beforeWrite?.(path);
+            writeFileSync(path, next, 'utf8');
+        }
+        changed.push(surface.path);
+    }
+    return { changed, skipped, diagnostics };
+}
+//# sourceMappingURL=migration.js.map