mewkit 1.7.1 → 1.8.0

package/dist/migrate/reconcile/reconcile-state-builders.js

@@ -0,0 +1,185 @@
+// Vendored from claudekit-cli (MIT). Source: src/commands/portable/reconcile-state-builders.ts
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { buildMergeSectionContent, computeManagedSectionChecksums, getMergeSectionKey, } from "../config-merger/merge-single-sections.js";
+import { convertItem } from "../converters/index.js";
+import { providers } from "../provider-registry.js";
+import { computeContentChecksum } from "./checksum-utils.js";
+function getProviderPathKeyForPortableType(type) {
+    switch (type) {
+        case "agent": return "agents";
+        case "command": return "commands";
+        case "skill": return "skills";
+        case "config": return "config";
+        case "rules": return "rules";
+        case "hooks": return "hooks";
+    }
+}
+function getProviderPathConfig(provider, type) {
+    return providers[provider]?.[getProviderPathKeyForPortableType(type)] ?? null;
+}
+function usesMergeSingleChecksums(entry) {
+    const pathConfig = getProviderPathConfig(entry.provider, entry.type);
+    return pathConfig?.writeStrategy === "merge-single";
+}
+function buildTargetChecksum(item, type, provider, convertedContent) {
+    const pathConfig = getProviderPathConfig(provider, type);
+    if (!pathConfig)
+        return computeContentChecksum(item.body);
+    if (pathConfig.writeStrategy === "yaml-merge" || pathConfig.writeStrategy === "json-merge") {
+        return undefined;
+    }
+    if (pathConfig.writeStrategy !== "merge-single") {
+        return computeContentChecksum(convertedContent);
+    }
+    const sectionKind = type === "config" ? "config" : type === "rules" ? "rule" : type === "agent" ? "agent" : null;
+    if (!sectionKind)
+        return undefined;
+    const sectionKey = getMergeSectionKey(sectionKind, item);
+    return computeContentChecksum(buildMergeSectionContent(sectionKind, sectionKey, convertedContent));
+}
+export function buildConvertedChecksums(item, type, selectedProviders, options) {
+    const rawChecksum = computeContentChecksum(item.body);
+    const convertedChecksums = {};
+    for (const provider of selectedProviders) {
+        const pathConfig = getProviderPathConfig(provider, type);
+        if (!pathConfig) {
+            convertedChecksums[provider] = rawChecksum;
+            continue;
+        }
+        const result = convertItem(item, pathConfig.format, provider);
+        if (result.error) {
+            options?.onConversionFallback?.({
+                item: item.name, type, provider, format: pathConfig.format, error: result.error,
+            });
+            convertedChecksums[provider] = rawChecksum;
+            continue;
+        }
+        convertedChecksums[provider] = computeContentChecksum(result.content);
+    }
+    return convertedChecksums;
+}
+export function buildSourceItemState(item, type, selectedProviders, options) {
+    const rawChecksum = computeContentChecksum(item.body);
+    const convertedChecksums = buildConvertedChecksums(item, type, selectedProviders, options);
+    const targetChecksums = {};
+    for (const provider of selectedProviders) {
+        const pathConfig = getProviderPathConfig(provider, type);
+        if (!pathConfig) {
+            targetChecksums[provider] = rawChecksum;
+            continue;
+        }
+        const result = convertItem(item, pathConfig.format, provider);
+        if (result.error) {
+            targetChecksums[provider] = rawChecksum;
+            continue;
+        }
+        const targetChecksum = buildTargetChecksum(item, type, provider, result.content);
+        if (targetChecksum)
+            targetChecksums[provider] = targetChecksum;
+    }
+    return {
+        item: item.name,
+        type,
+        sourceChecksum: rawChecksum,
+        convertedChecksums,
+        targetChecksums,
+    };
+}
+export function buildTypeDirectoryStates(providerConfigs, types) {
+    const results = [];
+    for (const { provider, global: isGlobal } of providerConfigs) {
+        const providerConfig = providers[provider];
+        if (!providerConfig)
+            continue;
+        for (const type of types) {
+            const pathKey = getProviderPathKeyForPortableType(type);
+            const pathConfig = providerConfig[pathKey];
+            if (!pathConfig)
+                continue;
+            if (pathConfig.writeStrategy === "merge-single" ||
+                pathConfig.writeStrategy === "single-file") {
+                continue;
+            }
+            const dirPath = isGlobal ? pathConfig.globalPath : pathConfig.projectPath;
+            if (!dirPath)
+                continue;
+            const exists = existsSync(dirPath);
+            if (!exists) {
+                results.push({
+                    provider, type, global: isGlobal, path: dirPath,
+                    exists: false, isEmpty: true, fileCount: 0,
+                });
+                continue;
+            }
+            let stat = null;
+            try {
+                stat = statSync(dirPath);
+            }
+            catch {
+                results.push({
+                    provider, type, global: isGlobal, path: dirPath,
+                    exists: false, isEmpty: true, fileCount: 0,
+                });
+                continue;
+            }
+            if (!stat.isDirectory()) {
+                results.push({
+                    provider, type, global: isGlobal, path: dirPath,
+                    exists: true, isEmpty: false, fileCount: 1,
+                });
+                continue;
+            }
+            const ext = pathConfig.fileExtension ?? "";
+            let entries = [];
+            try {
+                entries = readdirSync(dirPath);
+            }
+            catch {
+                results.push({
+                    provider, type, global: isGlobal, path: dirPath,
+                    exists: true, isEmpty: true, fileCount: 0,
+                });
+                continue;
+            }
+            const managedFiles = ext === ""
+                ? entries.filter((f) => f.endsWith(".json") || f.endsWith(".sh") || f.endsWith(".js"))
+                : entries.filter((f) => f.endsWith(ext));
+            results.push({
+                provider, type, global: isGlobal, path: dirPath,
+                exists: true, isEmpty: managedFiles.length === 0, fileCount: managedFiles.length,
+            });
+        }
+    }
+    return results;
+}
+export async function buildTargetStates(entries, options) {
+    const targetStates = new Map();
+    const entriesByPath = new Map();
+    for (const entry of entries) {
+        if (entry.type === "skill")
+            continue;
+        const group = entriesByPath.get(entry.path) ?? [];
+        group.push(entry);
+        entriesByPath.set(entry.path, group);
+    }
+    for (const [entryPath, groupedEntries] of entriesByPath) {
+        const exists = existsSync(entryPath);
+        const state = { path: entryPath, exists };
+        if (exists) {
+            try {
+                const content = await readFile(entryPath, "utf-8");
+                state.currentChecksum = computeContentChecksum(content);
+                if (groupedEntries.some((entry) => usesMergeSingleChecksums(entry))) {
+                    state.sectionChecksums = computeManagedSectionChecksums(content);
+                }
+            }
+            catch (error) {
+                options?.onReadFailure?.(entryPath, error);
+            }
+        }
+        targetStates.set(entryPath, state);
+    }
+    return targetStates;
+}
+//# sourceMappingURL=reconcile-state-builders.js.map

package/dist/migrate/reconcile/reconcile-state-builders.js.map

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

package/dist/migrate/reconcile/reconcile-types.d.ts

@@ -0,0 +1,113 @@
+import type { PortableRegistryV3 } from "./portable-registry.js";
+export declare const UNKNOWN_CHECKSUM: "unknown";
+export declare function normalizeChecksum(checksum: string | undefined | null): string;
+export declare function isUnknownChecksum(checksum: string | undefined | null): boolean;
+export type ReconcileReason = "new-item" | "new-provider-for-item" | "target-deleted-source-changed" | "target-dir-empty-reinstall" | "force-reinstall" | "force-overwrite" | "registry-upgrade-reinstall" | "source-changed" | "registry-upgrade-heal" | "no-changes" | "user-edits-preserved" | "user-deleted-respected" | "target-up-to-date-backfill" | "provider-checksum-unavailable" | "target-state-unknown" | "source-removed-orphan" | "renamed-cleanup" | "path-migrated-cleanup" | "both-changed" | "target-state-unknown-source-changed";
+export declare function getReasonCopy(code: ReconcileReason, _ctx?: Record<string, string>): string;
+export type ReconcileActionType = "install" | "update" | "skip" | "conflict" | "delete";
+export type ConflictResolution = {
+    type: "overwrite";
+} | {
+    type: "keep";
+} | {
+    type: "smart-merge";
+} | {
+    type: "resolved";
+    content: string;
+};
+export interface ReconcileAction {
+    action: ReconcileActionType;
+    item: string;
+    type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
+    provider: string;
+    global: boolean;
+    targetPath: string;
+    reason: string;
+    reasonCode?: ReconcileReason;
+    reasonCopy?: string;
+    isDirectoryItem?: boolean;
+    sourceChecksum?: string;
+    registeredSourceChecksum?: string;
+    currentTargetChecksum?: string;
+    registeredTargetChecksum?: string;
+    backfillRegistry?: boolean;
+    previousItem?: string;
+    previousPath?: string;
+    cleanupPaths?: string[];
+    ownedSections?: string[];
+    affectedSections?: string[];
+    diff?: string;
+    resolution?: ConflictResolution;
+}
+export interface SourceItemState {
+    item: string;
+    type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
+    sourceChecksum: string;
+    convertedChecksums: Record<string, string>;
+    targetChecksums?: Record<string, string>;
+}
+export interface TargetFileState {
+    path: string;
+    exists: boolean;
+    currentChecksum?: string;
+    sectionChecksums?: Record<string, string>;
+}
+export interface TargetDirectoryState {
+    provider: string;
+    type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
+    global: boolean;
+    path: string;
+    exists: boolean;
+    isEmpty: boolean;
+    fileCount: number;
+}
+export interface ReconcileBanner {
+    kind: "empty-dir" | "empty-dir-respected";
+    provider: string;
+    type: string;
+    global: boolean;
+    path: string;
+    itemCount: number;
+    message: string;
+}
+export interface ReconcileProviderInput {
+    provider: string;
+    global: boolean;
+}
+/** Manifest shape for renames/path migrations. Loose for v1; tighten when implemented. */
+export interface PortableManifest {
+    renames?: Array<{
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    pathMigrations?: Array<{
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface ReconcileInput {
+    sourceItems: SourceItemState[];
+    registry: PortableRegistryV3;
+    targetStates: Map<string, TargetFileState>;
+    manifest?: PortableManifest | null;
+    providerConfigs: ReconcileProviderInput[];
+    force?: boolean;
+    typeDirectoryStates?: TargetDirectoryState[];
+    respectDeletions?: boolean;
+}
+export interface ReconcilePlan {
+    actions: ReconcileAction[];
+    summary: {
+        install: number;
+        update: number;
+        skip: number;
+        conflict: number;
+        delete: number;
+    };
+    hasConflicts: boolean;
+    banners: ReconcileBanner[];
+}
+//# sourceMappingURL=reconcile-types.d.ts.map

package/dist/migrate/reconcile/reconcile-types.d.ts.map

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

package/dist/migrate/reconcile/reconcile-types.js

@@ -0,0 +1,42 @@
+// Vendored from claudekit-cli (MIT). Source: src/commands/portable/reconcile-types.ts
+// Pure types for idempotent migration planning. Manifest type loosened (mewkit defers
+// rename/path-migration to a follow-up; structure preserved for forward compat).
+export const UNKNOWN_CHECKSUM = "unknown";
+export function normalizeChecksum(checksum) {
+    if (!checksum)
+        return UNKNOWN_CHECKSUM;
+    const trimmed = checksum.trim();
+    if (!trimmed)
+        return UNKNOWN_CHECKSUM;
+    if (trimmed.toLowerCase() === UNKNOWN_CHECKSUM)
+        return UNKNOWN_CHECKSUM;
+    return trimmed;
+}
+export function isUnknownChecksum(checksum) {
+    return normalizeChecksum(checksum) === UNKNOWN_CHECKSUM;
+}
+export function getReasonCopy(code, _ctx) {
+    switch (code) {
+        case "new-item": return "New — not previously installed";
+        case "new-provider-for-item": return "New provider for existing item";
+        case "target-deleted-source-changed": return "You deleted this; mewkit has updates — reinstalling";
+        case "target-dir-empty-reinstall": return "Provider directory is empty — reinstalling";
+        case "force-reinstall": return "Force reinstall (target was deleted)";
+        case "force-overwrite": return "Force overwrite (you edited this, --force active)";
+        case "registry-upgrade-reinstall": return "Target deleted — reinstalling after registry upgrade";
+        case "source-changed": return "mewkit updated, you didn't edit — safe to overwrite";
+        case "registry-upgrade-heal": return "Healing stale target after registry upgrade";
+        case "no-changes": return "Already up to date";
+        case "user-edits-preserved": return "You edited this, mewkit unchanged — keeping your edits";
+        case "user-deleted-respected": return "You deleted this, mewkit unchanged — respecting your choice";
+        case "target-up-to-date-backfill": return "Already up to date — registry checksums will be backfilled";
+        case "provider-checksum-unavailable": return "Provider checksum unavailable — cannot verify safely";
+        case "target-state-unknown": return "Target state unavailable, mewkit unchanged — preserving target";
+        case "source-removed-orphan": return "No longer shipped by mewkit — will be removed";
+        case "renamed-cleanup": return "Renamed — cleaning up old path";
+        case "path-migrated-cleanup": return "Path migrated — cleaning up old location";
+        case "both-changed": return "Both you and mewkit changed this — pick one";
+        case "target-state-unknown-source-changed": return "Target state unavailable while mewkit changed — manual review required";
+    }
+}
+//# sourceMappingURL=reconcile-types.js.map

package/dist/migrate/reconcile/reconcile-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-types.js","sourceRoot":"","sources":["../../../src/migrate/reconcile/reconcile-types.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,sFAAsF;AACtF,iFAAiF;AAIjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAkB,CAAC;AAEnD,MAAM,UAAU,iBAAiB,CAAC,QAAmC;IACpE,IAAI,CAAC,QAAQ;QAAE,OAAO,gBAAgB,CAAC;IACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,gBAAgB,CAAC;IACtC,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IACxE,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAmC;IACpE,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAK,gBAAgB,CAAC;AACzD,CAAC;AAwBD,MAAM,UAAU,aAAa,CAAC,IAAqB,EAAE,IAA6B;IACjF,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,UAAU,CAAC,CAAC,OAAO,gCAAgC,CAAC;QACzD,KAAK,uBAAuB,CAAC,CAAC,OAAO,gCAAgC,CAAC;QACtE,KAAK,+BAA+B,CAAC,CAAC,OAAO,qDAAqD,CAAC;QACnG,KAAK,4BAA4B,CAAC,CAAC,OAAO,4CAA4C,CAAC;QACvF,KAAK,iBAAiB,CAAC,CAAC,OAAO,sCAAsC,CAAC;QACtE,KAAK,iBAAiB,CAAC,CAAC,OAAO,mDAAmD,CAAC;QACnF,KAAK,4BAA4B,CAAC,CAAC,OAAO,sDAAsD,CAAC;QACjG,KAAK,gBAAgB,CAAC,CAAC,OAAO,qDAAqD,CAAC;QACpF,KAAK,uBAAuB,CAAC,CAAC,OAAO,6CAA6C,CAAC;QACnF,KAAK,YAAY,CAAC,CAAC,OAAO,oBAAoB,CAAC;QAC/C,KAAK,sBAAsB,CAAC,CAAC,OAAO,wDAAwD,CAAC;QAC7F,KAAK,wBAAwB,CAAC,CAAC,OAAO,6DAA6D,CAAC;QACpG,KAAK,4BAA4B,CAAC,CAAC,OAAO,4DAA4D,CAAC;QACvG,KAAK,+BAA+B,CAAC,CAAC,OAAO,sDAAsD,CAAC;QACpG,KAAK,sBAAsB,CAAC,CAAC,OAAO,gEAAgE,CAAC;QACrG,KAAK,uBAAuB,CAAC,CAAC,OAAO,+CAA+C,CAAC;QACrF,KAAK,iBAAiB,CAAC,CAAC,OAAO,gCAAgC,CAAC;QAChE,KAAK,uBAAuB,CAAC,CAAC,OAAO,0CAA0C,CAAC;QAChF,KAAK,cAAc,CAAC,CAAC,OAAO,6CAA6C,CAAC;QAC1E,KAAK,qCAAqC,CAAC,CAAC,OAAO,wEAAwE,CAAC;IAC7H,CAAC;AACF,CAAC"}

package/dist/migrate/reconcile/reconciler.d.ts

@@ -0,0 +1,3 @@
+import type { ReconcileInput, ReconcilePlan } from "./reconcile-types.js";
+export declare function reconcile(input: ReconcileInput): ReconcilePlan;
+//# sourceMappingURL=reconciler.d.ts.map

package/dist/migrate/reconcile/reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.d.ts","sourceRoot":"","sources":["../../../src/migrate/reconcile/reconciler.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAGX,cAAc,EACd,aAAa,EAMb,MAAM,sBAAsB,CAAC;AAuN9B,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAwB9D"}