@monoes/monomindcli 2.9.24 → 2.9.27

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

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

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

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

@@ -0,0 +1,23 @@
+/** Planning and application for evidence-gated platform artifacts. */
+import type { ApplyResult, ArtifactKind, DiscoveryResult, InstallRequest, MutationRequest, PlatformAdapter, PlatformDoctorReport, PlatformPlan, ResolvedArtifactLocation } from './types.js';
+export interface PlatformEnvironment {
+    root?: string;
+    home?: string;
+    discovery?: DiscoveryResult;
+}
+export declare function redactUserPath(path: string, home?: string): string;
+/** The sole conversion from declarative adapter paths into real filesystem paths. */
+export declare function resolveArtifactLocation(adapter: PlatformAdapter, kind: ArtifactKind, scope: InstallRequest['scope'], environment?: PlatformEnvironment): ResolvedArtifactLocation | undefined;
+export declare function planInstall(request: InstallRequest): Promise<PlatformPlan>;
+export declare function applyPlan(plan: PlatformPlan, request: InstallRequest): Promise<ApplyResult>;
+export declare function installPlatform(request: InstallRequest): Promise<ApplyResult>;
+export declare function upgradePlatforms(request: MutationRequest): Promise<ApplyResult[]>;
+export declare function uninstallPlatform(request: MutationRequest): Promise<ApplyResult[]>;
+export declare function migrateLegacyInstall(request: MutationRequest): Promise<ApplyResult[]>;
+export declare function runPlatformsDoctor(request: {
+    platform?: PlatformAdapter['id'];
+    path?: string;
+    scope: InstallRequest['scope'];
+    home?: string;
+}): Promise<PlatformDoctorReport[]>;
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/platform-adapters/operations.ts"],"names":[],"mappings":"AAAA,sEAAsE;AA2BtE,OAAO,KAAK,EACV,WAAW,EAEX,YAAY,EACZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAgBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAY,GAAG,MAAM,CAMrE;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,WAAW,GAAE,mBAAwB,GACpC,wBAAwB,GAAG,SAAS,CAiBtC;AAQD,wBAAsB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAGhF;AAgND,wBAAsB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAmBjG;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAInF;AAwCD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAOvF;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAwExF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAE3F;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA2ClC"}