/** Selection helpers for filtering migration plan items before apply. */

import path from "node:path";

import { isRecord } from "@openclaw/normalization-core/record-coerce";

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import type { MigrationItem, MigrationPlan } from "../../plugins/types.js";

import { MIGRATION_CONFLICT_REASON_PHRASES } from "./output.js";

// Public selection tokens and skip reasons shared with prompt tests and apply filtering.

export const MIGRATION_SKILL_NOT_SELECTED_REASON = "not selected for migration";

export const MIGRATION_PLUGIN_NOT_SELECTED_REASON = "not selected for migration";

export const MIGRATION_SELECTION_ACCEPT = "__openclaw_migrate_accept_recommended__";

export const MIGRATION_SKILL_SELECTION_TOGGLE_ALL_OFF = MIGRATION_SELECTION_TOGGLE_ALL_OFF;

type InteractiveMigrationSelection = { action: "select"; selectedItemIds: Set<string> };

/** Interactive skill selection result consumed by the apply flow. */

export type InteractiveMigrationSkillSelection = InteractiveMigrationSelection;

/** Interactive plugin selection result consumed by the apply flow. */

export type InteractiveMigrationPluginSelection = InteractiveMigrationSelection;

function normalizeSelectionRef(value: string): string {

});

}

/** Returns skill copy items that can still be selected or deselected. */

export function getSelectableMigrationSkillItems(plan: MigrationPlan): MigrationItem[] {

return plan.items.filter(

(item) =>

);

}

/** Returns plugin install items that can still be selected or deselected. */

export function getSelectableMigrationPluginItems(plan: MigrationPlan): MigrationItem[] {

// Only source-installed curated Codex plugins become selectable install items.

// Cached/manual-review plugin bundles are emitted as manual items, the aggregate

);

}

/** Returns the stable checkbox value for a skill migration item. */

export function getMigrationSkillSelectionValue(item: MigrationItem): string {

return item.id;

}

/** Returns the stable checkbox value for a plugin migration item. */

export function getMigrationPluginSelectionValue(item: MigrationItem): string {

return item.id;

}

/** Formats the visible label for a plugin migration checkbox. */

export function formatMigrationPluginSelectionLabel(item: MigrationItem): string {

return readMigrationPluginName(item) ?? item.id.replace(/^plugin:/u, "");

}

/** Defaults skill selection to planned items only. */

export function getDefaultMigrationSkillSelectionValues(items: readonly MigrationItem[]): string[] {

return items.filter((item) => item.status === "planned").map(getMigrationSkillSelectionValue);

}

/** Defaults plugin selection to planned items only. */

export function getDefaultMigrationPluginSelectionValues(

items: readonly MigrationItem[],

): string[] {

return items.filter((item) => item.status === "planned").map(getMigrationPluginSelectionValue);

}

/** Formats the visible label for a skill migration checkbox. */

export function formatMigrationSkillSelectionLabel(item: MigrationItem): string {

return readMigrationSkillName(item) ?? item.id.replace(/^skill:/u, "");

}

return MIGRATION_CONFLICT_REASON_PHRASES[reason] ?? reason;

}

/** Formats conflict helper text for a skill migration checkbox. */

export function formatMigrationSkillSelectionHint(item: MigrationItem): string | undefined {

if (item.status !== "conflict") {

return undefined;

return sourceLabel ? `${sourceLabel} ${reason}` : reason;

}

/** Formats conflict helper text for a plugin migration checkbox. */

export function formatMigrationPluginSelectionHint(item: MigrationItem): string | undefined {

if (item.status !== "conflict") {

return undefined;

return marketplace ? `${marketplace} plugin ${reason}` : reason;

}

/** Marks unselected selectable skill items as skipped and recomputes plan summary. */

export function applyMigrationSelectedSkillItemIds(

plan: MigrationPlan,

selectedItemIds: ReadonlySet<string>,

};

}

/** Applies skill refs passed by CLI flags to a migration plan. */

export function applyMigrationSkillSelection(

plan: MigrationPlan,

selectedSkillRefs: readonly string[] | undefined,

return applyMigrationSelectedSkillItemIds(plan, selectedIds);

}

/** Applies plugin refs passed by CLI flags to a migration plan. */

export function applyMigrationPluginSelection(

plan: MigrationPlan,

selectedPluginRefs: readonly string[] | undefined,

return applyMigrationSelectedPluginItemIds(plan, selectedIds);

}

/** Marks unselected plugin items skipped and filters matching Codex plugin config writes. */

export function applyMigrationSelectedPluginItemIds(

plan: MigrationPlan,

selectedItemIds: ReadonlySet<string>,

return undefined;

}

/** Resolves checkbox values into selected skill migration item ids. */

export function resolveInteractiveMigrationSkillSelection(

items: readonly MigrationItem[],

selectedValues: readonly string[],

);

}

/** Resolves checkbox values into selected plugin migration item ids. */

export function resolveInteractiveMigrationPluginSelection(

items: readonly MigrationItem[],

selectedValues: readonly string[],

);

}

/** Reconciles all/none checkbox toggles for the skill-selection prompt. */

export function reconcileInteractiveMigrationSkillToggleValues(

selectedValues: readonly string[],

activatedValue: string | undefined,

);

}

/** Reconciles Enter-key selection behavior for interactive migration prompts. */

export function reconcileInteractiveMigrationEnterValues(

selectedValues: readonly string[],

activatedValue: string | undefined,

return [...selectedValues];

}

/** Reconciles keyboard shortcuts for all/none migration prompt selections. */

export function reconcileInteractiveMigrationShortcutValues(

previousValues: readonly string[],

selectedValues: readonly string[],