mewkit 1.6.7 → 1.7.0

package/dist/migrate/types.d.ts

@@ -0,0 +1,172 @@
+import { z } from "zod";
+/** Type of portable item */
+export type PortableType = "agent" | "command" | "skill" | "config" | "rules" | "hooks";
+/** Supported coding agent/provider identifiers */
+export declare const ProviderType: z.ZodEnum<["claude-code", "cursor", "codex", "droid", "opencode", "goose", "gemini-cli", "antigravity", "github-copilot", "amp", "kilo", "kiro", "roo", "windsurf", "cline", "openhands"]>;
+export type ProviderType = z.infer<typeof ProviderType>;
+/** Conversion format used to transform source files */
+export type ConversionFormat = "direct-copy" | "fm-to-fm" | "fm-to-yaml" | "fm-strip" | "fm-to-json" | "md-to-toml" | "skill-md" | "md-strip" | "md-to-mdc" | "md-to-kiro-steering" | "fm-to-codex-toml";
+/** Write strategy for target files */
+export type WriteStrategy = "per-file" | "merge-single" | "json-merge" | "yaml-merge" | "single-file" | "codex-toml" | "codex-hooks";
+/** Provider path configuration for a specific portable type */
+export interface ProviderPathConfig {
+    projectPath: string | null;
+    globalPath: string | null;
+    format: ConversionFormat;
+    writeStrategy: WriteStrategy;
+    fileExtension: string;
+    charLimit?: number;
+    totalCharLimit?: number;
+    nestedCommands?: boolean;
+}
+/** Provider's level of subagent/delegation support */
+export type SubagentSupport = "full" | "partial" | "none" | "planned";
+/** Full provider configuration */
+export interface ProviderConfig {
+    name: ProviderType;
+    displayName: string;
+    subagents: SubagentSupport;
+    agents: ProviderPathConfig | null;
+    commands: ProviderPathConfig | null;
+    skills: ProviderPathConfig | null;
+    config: ProviderPathConfig | null;
+    rules: ProviderPathConfig | null;
+    hooks: ProviderPathConfig | null;
+    settingsJsonPath: {
+        projectPath: string;
+        globalPath: string;
+    } | null;
+    detect: () => Promise<boolean>;
+    /** Optional patterns to exclude from discovery (mewkit-internal extension) */
+    excludePatterns?: string[];
+    /** Optional unverified marker — mewkit prints a runtime warning when set */
+    _unverified?: boolean;
+}
+/** Parsed frontmatter data from a source file */
+export interface ParsedFrontmatter {
+    name?: string;
+    description?: string;
+    model?: string;
+    tools?: string;
+    memory?: string;
+    argumentHint?: string;
+    [key: string]: unknown;
+}
+/** Result of frontmatter parsing */
+export interface FrontmatterParseResult {
+    frontmatter: ParsedFrontmatter;
+    body: string;
+    warnings: string[];
+}
+/** A portable item (agent, command, config, rule, hook) discovered from source */
+export interface PortableItem {
+    name: string;
+    displayName?: string;
+    description: string;
+    type: PortableType;
+    sourcePath: string;
+    frontmatter: ParsedFrontmatter;
+    body: string;
+    /** For nested commands: relative path segments (e.g., ["docs", "init"]) */
+    segments?: string[];
+}
+/** Result of converting a portable item for a target provider */
+export interface ConversionResult {
+    content: string;
+    filename: string;
+    warnings: string[];
+    error?: string;
+}
+/** Result of installing a portable item to a provider */
+export interface PortableInstallResult {
+    provider: ProviderType;
+    providerDisplayName: string;
+    success: boolean;
+    path: string;
+    operation?: "apply" | "delete";
+    error?: string;
+    overwritten?: boolean;
+    skipped?: boolean;
+    skipReason?: string;
+    warnings?: string[];
+    portableType?: PortableType;
+    itemName?: string;
+    collidingProviders?: ProviderType[];
+}
+/** Skill metadata for directory-based skill items */
+export interface SkillInfo {
+    /** Sanitized canonical name (colon-free) — e.g., "meow-cook" */
+    name: string;
+    /** Original directory name (may contain colon, e.g., "meow:cook") */
+    dirName: string;
+    /** Display name from frontmatter `name:` field */
+    displayName?: string;
+    description: string;
+    version?: string;
+    author?: string;
+    license?: string;
+    /** Full path to skill directory */
+    sourcePath: string;
+}
+/** Command options schema for migrate */
+export declare const MigrateOptionsSchema: z.ZodObject<{
+    tool: z.ZodOptional<z.ZodString>;
+    /** Preset list of provider names (used by init --migrate-to). Skips the interactive picker. */
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    all: z.ZodOptional<z.ZodBoolean>;
+    global: z.ZodOptional<z.ZodBoolean>;
+    yes: z.ZodOptional<z.ZodBoolean>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodString>;
+    only: z.ZodOptional<z.ZodString>;
+    skipConfig: z.ZodOptional<z.ZodBoolean>;
+    skipRules: z.ZodOptional<z.ZodBoolean>;
+    skipHooks: z.ZodOptional<z.ZodBoolean>;
+    install: z.ZodOptional<z.ZodBoolean>;
+    reconcile: z.ZodOptional<z.ZodBoolean>;
+    reinstallEmptyDirs: z.ZodOptional<z.ZodBoolean>;
+    respectDeletions: z.ZodOptional<z.ZodBoolean>;
+    preferAgentsMd: z.ZodOptional<z.ZodBoolean>;
+    sourceVersion: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source?: string | undefined;
+    tool?: string | undefined;
+    tools?: string[] | undefined;
+    all?: boolean | undefined;
+    global?: boolean | undefined;
+    yes?: boolean | undefined;
+    dryRun?: boolean | undefined;
+    force?: boolean | undefined;
+    only?: string | undefined;
+    skipConfig?: boolean | undefined;
+    skipRules?: boolean | undefined;
+    skipHooks?: boolean | undefined;
+    install?: boolean | undefined;
+    reconcile?: boolean | undefined;
+    reinstallEmptyDirs?: boolean | undefined;
+    respectDeletions?: boolean | undefined;
+    preferAgentsMd?: boolean | undefined;
+    sourceVersion?: string | undefined;
+}, {
+    source?: string | undefined;
+    tool?: string | undefined;
+    tools?: string[] | undefined;
+    all?: boolean | undefined;
+    global?: boolean | undefined;
+    yes?: boolean | undefined;
+    dryRun?: boolean | undefined;
+    force?: boolean | undefined;
+    only?: string | undefined;
+    skipConfig?: boolean | undefined;
+    skipRules?: boolean | undefined;
+    skipHooks?: boolean | undefined;
+    install?: boolean | undefined;
+    reconcile?: boolean | undefined;
+    reinstallEmptyDirs?: boolean | undefined;
+    respectDeletions?: boolean | undefined;
+    preferAgentsMd?: boolean | undefined;
+    sourceVersion?: string | undefined;
+}>;
+export type MigrateOptions = z.infer<typeof MigrateOptionsSchema>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/migrate/types.js

@@ -0,0 +1,45 @@
+// Vendored from claudekit-cli (MIT). Source: src/commands/portable/types.ts
+// Shared types for portable items (agents, commands, skills, config, rules, hooks).
+import { z } from "zod";
+/** Supported coding agent/provider identifiers */
+export const ProviderType = z.enum([
+    "claude-code",
+    "cursor",
+    "codex",
+    "droid",
+    "opencode",
+    "goose",
+    "gemini-cli",
+    "antigravity",
+    "github-copilot",
+    "amp",
+    "kilo",
+    "kiro",
+    "roo",
+    "windsurf",
+    "cline",
+    "openhands",
+]);
+/** Command options schema for migrate */
+export const MigrateOptionsSchema = z.object({
+    tool: z.string().optional(),
+    /** Preset list of provider names (used by init --migrate-to). Skips the interactive picker. */
+    tools: z.array(z.string()).optional(),
+    all: z.boolean().optional(),
+    global: z.boolean().optional(),
+    yes: z.boolean().optional(),
+    dryRun: z.boolean().optional(),
+    force: z.boolean().optional(),
+    source: z.string().optional(),
+    only: z.string().optional(),
+    skipConfig: z.boolean().optional(),
+    skipRules: z.boolean().optional(),
+    skipHooks: z.boolean().optional(),
+    install: z.boolean().optional(),
+    reconcile: z.boolean().optional(),
+    reinstallEmptyDirs: z.boolean().optional(),
+    respectDeletions: z.boolean().optional(),
+    preferAgentsMd: z.boolean().optional(),
+    sourceVersion: z.string().optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/migrate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/migrate/types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,oFAAoF;AACpF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IAClC,aAAa;IACb,QAAQ;IACR,OAAO;IACP,OAAO;IACP,UAAU;IACV,OAAO;IACP,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,UAAU;IACV,OAAO;IACP,WAAW;CACX,CAAC,CAAC;AAqIH,yCAAyC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,+FAA+F;IAC/F,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC1C,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mewkit",
-  "version": "1.6.7",
+  "version": "1.7.0",
   "description": "MeowKit CLI — scaffold, upgrade, and manage your AI agent toolkit",
   "type": "module",
   "bin": {
@@ -16,14 +16,22 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.8.2",
+    "@iarna/toml": "^2.2.5",
     "adm-zip": "^0.5.17",
+    "diff": "^5.2.0",
+    "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
-    "picocolors": "^1.1.0"
+    "picocolors": "^1.1.0",
+    "semver": "^7.6.0",
+    "zod": "^3.23.8"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.8",
+    "@types/diff": "^5.2.1",
+    "@types/js-yaml": "^4.0.9",
     "@types/minimist": "^1.2.5",
     "@types/node": "^20.14.0",
+    "@types/semver": "^7.5.8",
     "typescript": "^5.5.0"
   },
   "engines": {