@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.3

package/dist/codemod/schemas/recipe.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Codemod Recipe Descriptor Schema
+ *
+ * Defines the descriptor shape for codemod/recipe kind assets.
+ * Recipes are executable code transformations registered via the runtime.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+export declare const RecipeSafetySchema: z.ZodEnum<{
+    read: "read";
+    write: "write";
+}>;
+/**
+ * Schemas field for recipe descriptors.
+ * Holds Zod schema references for input/output validation at runtime.
+ */
+export declare const RecipeSchemasSchema: z.ZodObject<{
+    input: z.ZodUnknown;
+    output: z.ZodUnknown;
+}, z.core.$strip>;
+/**
+ * Codemod recipe descriptor schema.
+ *
+ * Built-in recipes: set `safety`, `schemas`, no `engine`/`config`.
+ * Saved recipes: set `engine` (ID of a built-in recipe) and `config` (pre-filled params).
+ */
+export declare const CodemodRecipeDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"codemod/recipe">;
+    safety: z.ZodEnum<{
+        read: "read";
+        write: "write";
+    }>;
+    requiresApproval: z.ZodOptional<z.ZodBoolean>;
+    schemas: z.ZodObject<{
+        input: z.ZodUnknown;
+        output: z.ZodUnknown;
+    }, z.core.$strip>;
+    engine: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+}, z.core.$strip>;
+export type RecipeSafety = z.infer<typeof RecipeSafetySchema>;
+export type CodemodRecipeDescriptor = z.infer<typeof CodemodRecipeDescriptorSchema>;
+/**
+ * The runtime the codemod tool was handed. A recipe reads from it the recipe
+ * registry, host commands, the kernel-composed child environment, the host
+ * cwd, the filesystem adapter kind and the bound workspace
+ * (`runtime/workspace-path`).
+ */
+export type CodemodRecipeRuntime = RuntimeRef;
+/** What a caller hands a recipe: JSON parameters, parsed by the recipe against its own input schema. */
+export declare const RecipeInputSchema: z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+export type RecipeInput = z.infer<typeof RecipeInputSchema>;
+/** What a built-in recipe answers: the output of one of the four recipes' schemas. */
+export declare const RecipeOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    matches: z.ZodArray<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        lines: z.ZodOptional<z.ZodString>;
+        range: z.ZodOptional<z.ZodObject<{
+            start: z.ZodOptional<z.ZodObject<{
+                line: z.ZodNumber;
+                column: z.ZodNumber;
+            }, z.core.$strip>>;
+            end: z.ZodOptional<z.ZodObject<{
+                line: z.ZodNumber;
+                column: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        pattern: z.ZodString;
+        matchCount: z.ZodNumber;
+        fileCount: z.ZodNumber;
+        language: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    result: z.ZodObject<{
+        output: z.ZodOptional<z.ZodString>;
+        dryRun: z.ZodBoolean;
+        filesChanged: z.ZodNumber;
+        matchCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    result: z.ZodObject<{
+        output: z.ZodOptional<z.ZodString>;
+        dryRun: z.ZodBoolean;
+        command: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    output: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodBoolean;
+    command: z.ZodArray<z.ZodString>;
+    results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        filesModified: z.ZodNumber;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    summary: z.ZodOptional<z.ZodObject<{
+        total: z.ZodNumber;
+        successful: z.ZodNumber;
+        failed: z.ZodNumber;
+        filesModified: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+export type RecipeOutput = z.infer<typeof RecipeOutputSchema>;
+/**
+ * Implementation interface for codemod/recipe assets.
+ * Both built-in and saved recipes conform to this shape.
+ */
+export interface CodemodRecipeExecution {
+    execute(input: RecipeInput, runtime: CodemodRecipeRuntime): Promise<RecipeOutput>;
+}
+//# sourceMappingURL=recipe.d.ts.map

package/dist/codemod/schemas/recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/codemod/schemas/recipe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAQ5B,eAAO,MAAM,kBAAkB;;;EAA4B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYxC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE9C,wGAAwG;AACxG,eAAO,MAAM,iBAAiB,2QAAwC,CAAC;AACvE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,sFAAsF;AACtF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClF"}

package/dist/codemod/schemas/recipe.js

@@ -0,0 +1,51 @@
+/**
+ * Codemod Recipe Descriptor Schema
+ *
+ * Defines the descriptor shape for codemod/recipe kind assets.
+ * Recipes are executable code transformations registered via the runtime.
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { astgrepApplyOutputSchema } from "./astgrep-apply.js";
+import { astgrepSearchOutputSchema } from "./astgrep-search.js";
+import { refactorImportsOutputSchema } from "./refactor-imports.js";
+import { renameIdentifierOutputSchema } from "./rename-identifier.js";
+export const RecipeSafetySchema = z.enum(['read', 'write']);
+/**
+ * Schemas field for recipe descriptors.
+ * Holds Zod schema references for input/output validation at runtime.
+ */
+export const RecipeSchemasSchema = z.object({
+    input: z.unknown(),
+    output: z.unknown()
+});
+/**
+ * Codemod recipe descriptor schema.
+ *
+ * Built-in recipes: set `safety`, `schemas`, no `engine`/`config`.
+ * Saved recipes: set `engine` (ID of a built-in recipe) and `config` (pre-filled params).
+ */
+export const CodemodRecipeDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('codemod/recipe'),
+    /** Read-only (search) or write (apply/rewrite) */
+    safety: RecipeSafetySchema,
+    /** Whether execution requires user approval */
+    requiresApproval: z.boolean().optional(),
+    /** Input/output validation schemas (Zod schema objects) */
+    schemas: RecipeSchemasSchema,
+    /** Engine recipe ID — saved recipes delegate to a built-in engine */
+    engine: z.string().optional(),
+    /** Pre-filled configuration merged with caller input for saved recipes */
+    config: z.record(z.string(), JsonValueSchema).optional()
+});
+/** What a caller hands a recipe: JSON parameters, parsed by the recipe against its own input schema. */
+export const RecipeInputSchema = z.record(z.string(), JsonValueSchema);
+/** What a built-in recipe answers: the output of one of the four recipes' schemas. */
+export const RecipeOutputSchema = z.union([
+    astgrepSearchOutputSchema,
+    astgrepApplyOutputSchema,
+    refactorImportsOutputSchema,
+    renameIdentifierOutputSchema
+]);
+//# sourceMappingURL=recipe.js.map

package/dist/codemod/schemas/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../../src/codemod/schemas/recipe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC3E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,kDAAkD;IAClD,MAAM,EAAE,kBAAkB;IAC1B,+CAA+C;IAC/C,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,2DAA2D;IAC3D,OAAO,EAAE,mBAAmB;IAC5B,qEAAqE;IACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,0EAA0E;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAaH,wGAAwG;AACxG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;AAGvE,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC;IACzC,yBAAyB;IACzB,wBAAwB;IACxB,2BAA2B;IAC3B,4BAA4B;CAC5B,CAAC,CAAC"}

package/dist/codemod/schemas/refactor-imports.d.ts

@@ -0,0 +1,17 @@
+import * as z from 'zod/v4';
+export declare const refactorImportsInputSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const refactorImportsOutputSchema: z.ZodObject<{
+    result: z.ZodObject<{
+        output: z.ZodOptional<z.ZodString>;
+        dryRun: z.ZodBoolean;
+        command: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RefactorImportsInput = z.infer<typeof refactorImportsInputSchema>;
+export type RefactorImportsOutput = z.infer<typeof refactorImportsOutputSchema>;
+//# sourceMappingURL=refactor-imports.d.ts.map

package/dist/codemod/schemas/refactor-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor-imports.d.ts","sourceRoot":"","sources":["../../../src/codemod/schemas/refactor-imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;iBAEtC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/codemod/schemas/refactor-imports.js

@@ -0,0 +1,12 @@
+import * as z from 'zod/v4';
+import { commandResultSchema } from "../tools/command-result.schema.js";
+export const refactorImportsInputSchema = z.object({
+    from: z.string().min(1),
+    to: z.string().min(1),
+    paths: z.array(z.string()).max(50).optional(),
+    dryRun: z.boolean().optional()
+});
+export const refactorImportsOutputSchema = z.object({
+    result: commandResultSchema
+});
+//# sourceMappingURL=refactor-imports.js.map

package/dist/codemod/schemas/refactor-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor-imports.js","sourceRoot":"","sources":["../../../src/codemod/schemas/refactor-imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,MAAM,EAAE,mBAAmB;CAC3B,CAAC,CAAC"}

package/dist/codemod/schemas/rename-identifier.d.ts

@@ -0,0 +1,36 @@
+import * as z from 'zod/v4';
+export declare const renameIdentifierInputSchema: z.ZodObject<{
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    renames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    language: z.ZodOptional<z.ZodEnum<{
+        ts: "ts";
+        js: "js";
+        tsx: "tsx";
+        jsx: "jsx";
+    }>>;
+    apply: z.ZodOptional<z.ZodBoolean>;
+    saveName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const renameIdentifierOutputSchema: z.ZodObject<{
+    output: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodBoolean;
+    command: z.ZodArray<z.ZodString>;
+    results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        filesModified: z.ZodNumber;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    summary: z.ZodOptional<z.ZodObject<{
+        total: z.ZodNumber;
+        successful: z.ZodNumber;
+        failed: z.ZodNumber;
+        filesModified: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RenameIdentifierInput = z.infer<typeof renameIdentifierInputSchema>;
+export type RenameIdentifierOutput = z.infer<typeof renameIdentifierOutputSchema>;
+//# sourceMappingURL=rename-identifier.d.ts.map

package/dist/codemod/schemas/rename-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-identifier.d.ts","sourceRoot":"","sources":["../../../src/codemod/schemas/rename-identifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAQtC,CAAC;AAUH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;iBAUvC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/codemod/schemas/rename-identifier.js

@@ -0,0 +1,30 @@
+import * as z from 'zod/v4';
+import { commandResultSchema } from "../tools/command-result.schema.js";
+export const renameIdentifierInputSchema = z.object({
+    from: z.string().min(1).optional(),
+    to: z.string().min(1).optional(),
+    renames: z.record(z.string(), z.string()).optional(),
+    paths: z.array(z.string()).max(50).optional(),
+    language: z.enum(['ts', 'tsx', 'js', 'jsx']).optional(),
+    apply: z.boolean().optional(),
+    saveName: z.string().optional()
+});
+const renameResultSchema = z.object({
+    from: z.string(),
+    to: z.string(),
+    filesModified: z.number(),
+    success: z.boolean(),
+    error: z.string().optional()
+});
+export const renameIdentifierOutputSchema = commandResultSchema.extend({
+    results: z.array(renameResultSchema).optional(),
+    summary: z
+        .object({
+        total: z.number(),
+        successful: z.number(),
+        failed: z.number(),
+        filesModified: z.number()
+    })
+        .optional()
+});
+//# sourceMappingURL=rename-identifier.js.map

package/dist/codemod/schemas/rename-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-identifier.js","sourceRoot":"","sources":["../../../src/codemod/schemas/rename-identifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACtE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IAC/C,OAAO,EAAE,CAAC;SACR,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KACzB,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC"}

package/dist/codemod/tools/bun-child.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The Bun children the codemod tools run: `bun ast-grep …` and `bun vibes …`.
+ *
+ * Bun itself is named by the environment owner (the running Bun, or the
+ * compiled host under BUN_BE_BUN), never a `bun` guessed from PATH. Every
+ * child runs under the handed runtime's execution kind (see
+ * `../../utils/exec.ts`), with the kernel's composed child environment plus
+ * Bun's own declared variables, never the whole process snapshot.
+ */
+import { type ChildEnvRuntime, type RuntimeCwdRuntime } from '@vibesdotdev/kernel';
+import { type ExecRuntime, type RunCaptureResult } from '../../utils/exec.ts';
+/**
+ * What the codemod helpers read from the runtime they are handed: host
+ * commands, the child environment the kernel composes, the host cwd, and the
+ * execution kind and lifecycle that own every child.
+ */
+export type CodemodRuntime = ChildEnvRuntime & RuntimeCwdRuntime & ExecRuntime;
+/** Declared deadline for a Bun child (ast-grep search, rewrite, rule tests, a CLI refactor over a workspace). */
+export declare const BUN_CHILD_DEADLINE_MS: number;
+/** Run Bun with `args` and capture its output. */
+export declare function captureBun(runtime: CodemodRuntime, args: readonly string[], options?: {
+    cwd?: string;
+    timeoutMs?: number;
+}): Promise<RunCaptureResult>;
+/** Run ast-grep (the `@ast-grep/cli` bin, which needs Bun) with inherited stdio; resolves to its exit code. */
+export declare function runAstGrep(runtime: CodemodRuntime, args: readonly string[], options?: {
+    cwd?: string;
+}): Promise<number>;
+/** Run ast-grep and capture its output. */
+export declare function captureAstGrep(runtime: CodemodRuntime, args: readonly string[], options?: {
+    cwd?: string;
+    timeoutMs?: number;
+}): Promise<RunCaptureResult>;
+/** Ensure ast-grep is available via Bun. */
+export declare function ensureAstGrepAvailable(runtime: CodemodRuntime): Promise<void>;
+//# sourceMappingURL=bun-child.d.ts.map

package/dist/codemod/tools/bun-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-child.d.ts","sourceRoot":"","sources":["../../../src/codemod/tools/bun-child.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAKN,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtG;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAE/E,iHAAiH;AACjH,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAgBjD,kDAAkD;AAClD,wBAAsB,UAAU,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAED,+GAA+G;AAC/G,wBAAsB,UAAU,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,2CAA2C;AAC3C,wBAAsB,cAAc,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,4CAA4C;AAC5C,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CASnF"}

package/dist/codemod/tools/bun-child.js

@@ -0,0 +1,55 @@
+/**
+ * The Bun children the codemod tools run: `bun ast-grep …` and `bun vibes …`.
+ *
+ * Bun itself is named by the environment owner (the running Bun, or the
+ * compiled host under BUN_BE_BUN), never a `bun` guessed from PATH. Every
+ * child runs under the handed runtime's execution kind (see
+ * `../../utils/exec.ts`), with the kernel's composed child environment plus
+ * Bun's own declared variables, never the whole process snapshot.
+ */
+import { CapabilityError, composeChildEnv, getRuntimeHostCommands, requireRuntimeCwd } from '@vibesdotdev/kernel';
+import { runCapture, runInherit } from "../../utils/exec.js";
+/** Declared deadline for a Bun child (ast-grep search, rewrite, rule tests, a CLI refactor over a workspace). */
+export const BUN_CHILD_DEADLINE_MS = 10 * 60_000;
+/** Declared deadline for the ast-grep availability probe (`--version`). */
+const AST_GREP_PROBE_DEADLINE_MS = 60_000;
+/** The Bun command line for `args`, with the environment its child runs under. */
+async function bunInvocation(runtime, args) {
+    const bun = (await getRuntimeHostCommands(runtime)).scriptRuntimeArgv();
+    const [command, ...prefix] = bun.argv;
+    return { command, args: [...prefix, ...args], env: composeChildEnv(runtime, { env: bun.env }) };
+}
+/** Run Bun with `args` and capture its output. */
+export async function captureBun(runtime, args, options = {}) {
+    const invocation = await bunInvocation(runtime, args);
+    return runCapture(runtime, invocation.command, invocation.args, {
+        cwd: options.cwd ?? requireRuntimeCwd(runtime),
+        env: invocation.env,
+        timeoutMs: options.timeoutMs ?? BUN_CHILD_DEADLINE_MS
+    });
+}
+/** Run ast-grep (the `@ast-grep/cli` bin, which needs Bun) with inherited stdio; resolves to its exit code. */
+export async function runAstGrep(runtime, args, options = {}) {
+    const invocation = await bunInvocation(runtime, ['ast-grep', ...args]);
+    return runInherit(runtime, invocation.command, invocation.args, {
+        cwd: options.cwd ?? requireRuntimeCwd(runtime),
+        env: invocation.env,
+        timeoutMs: BUN_CHILD_DEADLINE_MS
+    });
+}
+/** Run ast-grep and capture its output. */
+export async function captureAstGrep(runtime, args, options = {}) {
+    return captureBun(runtime, ['ast-grep', ...args], options);
+}
+/** Ensure ast-grep is available via Bun. */
+export async function ensureAstGrepAvailable(runtime) {
+    const probe = await captureAstGrep(runtime, ['--version'], { timeoutMs: AST_GREP_PROBE_DEADLINE_MS });
+    if (probe.exitCode !== 0) {
+        throw new CapabilityError('ast-grep is not installed.', 'UNAVAILABLE', {
+            reason: 'codemod-astgrep-unavailable',
+            retryable: false,
+            recoveryHint: 'Run: bun add -d @ast-grep/cli'
+        });
+    }
+}
+//# sourceMappingURL=bun-child.js.map

package/dist/codemod/tools/bun-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-child.js","sourceRoot":"","sources":["../../../src/codemod/tools/bun-child.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACN,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EAGjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAA2C,MAAM,qBAAqB,CAAC;AAStG,iHAAiH;AACjH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,MAAM,CAAC;AAEjD,2EAA2E;AAC3E,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAE1C,kFAAkF;AAClF,KAAK,UAAU,aAAa,CAAC,OAAuB,EAAE,IAAuB;IAK5E,MAAM,GAAG,GAAG,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;IACxE,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;AACjG,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,OAAuB,EACvB,IAAuB,EACvB,UAAgD,EAAE;IAElD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE;QAC/D,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAC9C,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,qBAAqB;KACrD,CAAC,CAAC;AACJ,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,OAAuB,EACvB,IAAuB,EACvB,UAA4B,EAAE;IAE9B,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE;QAC/D,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAC9C,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,SAAS,EAAE,qBAAqB;KAChC,CAAC,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAAuB,EACvB,IAAuB,EACvB,UAAgD,EAAE;IAElD,OAAO,UAAU,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAuB;IACnE,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACtG,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CAAC,4BAA4B,EAAE,aAAa,EAAE;YACtE,MAAM,EAAE,6BAA6B;YACrC,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,+BAA+B;SAC7C,CAAC,CAAC;IACJ,CAAC;AACF,CAAC"}

package/dist/codemod/tools/command-result.schema.d.ts

@@ -0,0 +1,8 @@
+import * as z from 'zod/v4';
+export declare const commandResultSchema: z.ZodObject<{
+    output: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodBoolean;
+    command: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type CommandResult = z.infer<typeof commandResultSchema>;
+//# sourceMappingURL=command-result.schema.d.ts.map

package/dist/codemod/tools/command-result.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-result.schema.d.ts","sourceRoot":"","sources":["../../../src/codemod/tools/command-result.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/codemod/tools/command-result.schema.js

@@ -0,0 +1,7 @@
+import * as z from 'zod/v4';
+export const commandResultSchema = z.object({
+    output: z.string().optional(),
+    dryRun: z.boolean(),
+    command: z.array(z.string())
+});
+//# sourceMappingURL=command-result.schema.js.map

package/dist/codemod/tools/command-result.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-result.schema.js","sourceRoot":"","sources":["../../../src/codemod/tools/command-result.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC"}

package/dist/codemod/tools/shared.impl.consumer.d.ts

@@ -0,0 +1,15 @@
+import { Lang, type SgNode } from '@ast-grep/napi';
+import { type CodemodRuntime } from './bun-child.ts';
+export type { CodemodRuntime } from './bun-child.ts';
+export declare function resolveNapiLang(input?: string): Lang;
+/**
+ * Replace metavariable references in a rewrite template with matched values.
+ * Handles $$$VAR (variadic) and $VAR (single capture).
+ */
+export declare function substituteMetavars(rewrite: string, node: SgNode): string;
+export declare function resolveCliLanguage(input?: string): string;
+/** Run Bun with `args` under the runtime; a non-zero exit refuses with the child's own output. */
+export declare function runBunCommand(runtime: CodemodRuntime, args: string[]): Promise<string>;
+export declare function codeFenceForLanguage(input: string): string;
+export { commandResultSchema } from './command-result.schema.ts';
+//# sourceMappingURL=shared.impl.consumer.d.ts.map

package/dist/codemod/tools/shared.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/codemod/tools/shared.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAoBrD,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWxE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,kGAAkG;AAClG,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAW5F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW1D;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/codemod/tools/shared.impl.consumer.js

@@ -0,0 +1,73 @@
+import { Lang } from '@ast-grep/napi';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { captureBun } from "./bun-child.js";
+const LANGUAGE_ALIASES = new Map([
+    ['typescript', 'ts'],
+    ['ts', 'ts'],
+    ['javascript', 'js'],
+    ['js', 'js'],
+    ['tsx', 'tsx'],
+    ['jsx', 'jsx']
+]);
+const NAPI_LANG_MAP = new Map([
+    ['typescript', Lang.TypeScript],
+    ['ts', Lang.TypeScript],
+    ['javascript', Lang.JavaScript],
+    ['js', Lang.JavaScript],
+    ['tsx', Lang.Tsx],
+    ['jsx', Lang.Tsx]
+]);
+export function resolveNapiLang(input) {
+    if (!input)
+        return Lang.TypeScript;
+    return NAPI_LANG_MAP.get(input.toLowerCase()) ?? Lang.TypeScript;
+}
+/**
+ * Replace metavariable references in a rewrite template with matched values.
+ * Handles $$$VAR (variadic) and $VAR (single capture).
+ */
+export function substituteMetavars(rewrite, node) {
+    let result = rewrite;
+    result = result.replace(/\$\$\$([A-Z_][A-Z0-9_]*)/g, (_, name) => {
+        const matches = node.getMultipleMatches(name);
+        return matches.map((m) => m.text()).join(', ');
+    });
+    result = result.replace(/\$([A-Z_][A-Z0-9_]*)/g, (_, name) => {
+        const match = node.getMatch(name);
+        return match?.text() ?? `$${name}`;
+    });
+    return result;
+}
+export function resolveCliLanguage(input) {
+    if (!input)
+        return 'ts';
+    const key = input.toLowerCase();
+    return LANGUAGE_ALIASES.get(key) ?? 'ts';
+}
+/** Run Bun with `args` under the runtime; a non-zero exit refuses with the child's own output. */
+export async function runBunCommand(runtime, args) {
+    const result = await captureBun(runtime, args);
+    if (result.exitCode !== 0) {
+        const detail = result.stderr.trim() || result.stdout.trim();
+        throw new CapabilityError(detail || `bun exited with code ${result.exitCode}`, 'UNAVAILABLE', {
+            reason: 'codemod-bun-command-failed',
+            retryable: false,
+            details: { exitCode: result.exitCode }
+        });
+    }
+    return result.stdout.trim();
+}
+export function codeFenceForLanguage(input) {
+    switch (resolveCliLanguage(input)) {
+        case 'js':
+            return 'javascript';
+        case 'tsx':
+            return 'tsx';
+        case 'jsx':
+            return 'jsx';
+        default:
+            return 'ts';
+    }
+}
+export { commandResultSchema } from "./command-result.schema.js";
+//# sourceMappingURL=shared.impl.consumer.js.map

package/dist/codemod/tools/shared.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.impl.consumer.js","sourceRoot":"","sources":["../../../src/codemod/tools/shared.impl.consumer.ts"],"names":[],"mappings":"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"}

package/dist/codemod/tools/unified/codemod.descriptor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Codemod Tool Descriptor
+ *
+ * MCP-facing tool that resolves and executes codemod recipes.
+ * Accepts a recipe ID and parameters, delegates to the codemod/recipe kind.
+ */
+import * as z from 'zod/v4';
+export declare const CodemodToolInputSchema: z.ZodObject<{
+    recipe: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+}, z.core.$strip>;
+export declare const CodemodToolOutputSchema: z.ZodObject<{}, z.core.$loose>;
+export type CodemodToolInput = z.infer<typeof CodemodToolInputSchema>;
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "codemod";
+    readonly name: "Codemod";
+    readonly description: "Run codemod recipes: astgrep-search, astgrep-apply, refactor-imports, rename-identifier, or saved recipes.";
+    readonly mcpDescription: "Run codemod recipes by ID. Ex: {recipe:\"astgrep-search\",params:{}}.";
+    readonly category: "refactor";
+    readonly hardware: ["consumer"];
+    readonly purpose: ["direct", "worker", "mcp"];
+    readonly tags: ["codemod", "astgrep", "refactor", "rename", "recipes"];
+    readonly safety: "write";
+    readonly requiresApproval: true;
+    readonly permissions: ["canAccessFilesystem"];
+    readonly schemas: {
+        readonly input: z.ZodObject<{
+            recipe: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+        }, z.core.$strip>;
+        readonly output: z.ZodObject<{}, z.core.$loose>;
+    };
+};
+export default _default;
+//# sourceMappingURL=codemod.descriptor.d.ts.map

package/dist/codemod/tools/unified/codemod.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemod.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/codemod/tools/unified/codemod.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,sBAAsB;;;iBAUjC,CAAC;AAEH,eAAO,MAAM,uBAAuB,gCAAoB,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;AAEtE,wBAkBG"}

package/dist/codemod/tools/unified/codemod.descriptor.js

@@ -0,0 +1,38 @@
+/**
+ * Codemod Tool Descriptor
+ *
+ * MCP-facing tool that resolves and executes codemod recipes.
+ * Accepts a recipe ID and parameters, delegates to the codemod/recipe kind.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import { RecipeInputSchema } from "../../schemas/recipe.js";
+export const CodemodToolInputSchema = z.object({
+    recipe: z
+        .string()
+        .min(1)
+        .describe('Recipe ID to execute (e.g. astgrep-search, astgrep-apply, refactor-imports, rename-identifier, or a saved recipe ID)'),
+    params: RecipeInputSchema
+        .optional()
+        .describe('Parameters for the recipe. Schema depends on the recipe.')
+});
+export const CodemodToolOutputSchema = z.looseObject({});
+export default createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'codemod',
+    name: 'Codemod',
+    description: 'Run codemod recipes: astgrep-search, astgrep-apply, refactor-imports, rename-identifier, or saved recipes.',
+    mcpDescription: 'Run codemod recipes by ID. Ex: {recipe:"astgrep-search",params:{}}.',
+    category: 'refactor',
+    hardware: ['consumer'],
+    purpose: ['direct', 'worker', 'mcp'],
+    tags: ['codemod', 'astgrep', 'refactor', 'rename', 'recipes'],
+    safety: 'write',
+    requiresApproval: true,
+    permissions: ['canAccessFilesystem'],
+    schemas: {
+        input: CodemodToolInputSchema,
+        output: CodemodToolOutputSchema
+    }
+});
+//# sourceMappingURL=codemod.descriptor.js.map

package/dist/codemod/tools/unified/codemod.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemod.descriptor.js","sourceRoot":"","sources":["../../../../src/codemod/tools/unified/codemod.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,sHAAsH,CACtH;IACF,MAAM,EAAE,iBAAiB;SACvB,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAIzD,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,WAAW,EACV,4GAA4G;IAC7G,cAAc,EAAE,qEAAqE;IACrF,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;IACpC,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;IAC7D,MAAM,EAAE,OAAO;IACf,gBAAgB,EAAE,IAAI;IACtB,WAAW,EAAE,CAAC,qBAAqB,CAAC;IACpC,OAAO,EAAE;QACR,KAAK,EAAE,sBAAsB;QAC7B,MAAM,EAAE,uBAAuB;KAC/B;CACD,CAAC,CAAC"}