@akanjs/devkit 3.1.2-rc.1 → 3.1.2-rc.2

package/akanMcpContract.ts

@@ -188,6 +188,8 @@ export const defaultWorkflowPlanPath = (workflow: string, inputs: WorkflowPlanIn
     slugPart(inputs.surface),
     slugPart(inputs.mutation),
     slugPart(inputs.slice),
+    slugPart(inputs.query),
+    slugPart(inputs.to),
   ]
     .filter(Boolean)
     .join("-");

package/codeAgent/skills/akan-scaffold/SKILL.md

@@ -32,6 +32,7 @@ Then pick the workflow that matches the intent:
 | a new field with a closed set of values | `add-enum-field` |
 | a new state-changing action | `add-mutation` |
 | a filtered list, tab, or reusable query | `add-slice` |
+| a slice or query key renamed, with every name derived from it | `rename-key` |
 | a View / Unit / Template / Zone / Util for an existing module | `create-ui` |
 
 ## The chain

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "3.1.2-rc.1",
+  "version": "3.1.2-rc.2",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -41,7 +41,7 @@
     "./*": "./*.ts"
   },
   "dependencies": {
-    "@akanjs/language": "3.1.2-rc.1",
+    "@akanjs/language": "3.1.2-rc.2",
     "@earendil-works/pi-agent-core": "1.3.0",
     "@earendil-works/pi-ai": "1.3.0",
     "@earendil-works/pi-codemode": "1.3.0",
@@ -50,7 +50,7 @@
     "@earendil-works/pi-tui": "1.3.0",
     "@inquirer/prompts": "^8.7.3",
     "@tailwindcss/node": "^4.3.3",
-    "akanjs": "3.1.2-rc.1",
+    "akanjs": "3.1.2-rc.2",
     "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "dayjs": "^1.11.23",

package/workflow/executor.ts

@@ -404,6 +404,7 @@ export const createWorkflowStepRegistry = ({
   addEnumField,
   addMutation,
   addSlice,
+  renameKey,
   createInteraction,
 }: WorkflowPrimitiveOperations): WorkflowStepRegistry => {
   const inspect = async () => undefined;
@@ -520,6 +521,16 @@ export const createWorkflowStepRegistry = ({
       ),
     [workflowStepKey("add-slice", "update-signal-slice")]: inspect,
     [workflowStepKey("add-slice", "connect-view-surfaces")]: async (_step, plan) => addSliceViewSurfaceInspection(plan),
+    [workflowStepKey("rename-key", "rename-key")]: async (_step, plan) =>
+      primitiveReportToWorkflowStepResult(
+        await renameKey({
+          app: workflowStringInput(plan.inputs.app),
+          module: workflowStringInput(plan.inputs.module),
+          slice: workflowStringInput(plan.inputs.slice),
+          query: workflowStringInput(plan.inputs.query),
+          to: workflowStringInput(plan.inputs.to),
+        }),
+      ),
   };
 };
 

package/workflow/index.ts

@@ -2,6 +2,7 @@ export * from "./artifacts";
 export * from "./executor";
 export * from "./guardCatalog";
 export * from "./interactionScaffold";
+export * from "./keyRename";
 export * from "./moduleIndex";
 export * from "./mutationScaffold";
 export * from "./mutationSource";

package/workflow/keyRename.ts

@@ -0,0 +1,78 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { AkanIndex, type AkanRenameEdit } from "@akanjs/language";
+import ts from "typescript";
+import type { Workspace } from "../commandDecorators";
+import { resolveWorkflowSys } from "./executor";
+import { getSysRoot, moduleSourcePaths } from "./source";
+import type { RenameKeyInput, ScaffoldFile, WorkflowDiagnostic } from "./types";
+
+const indexedPath = /^(apps|libs)\/(?!(?:.*\/)?(?:node_modules|dist|\.akan)\/).*\.tsx?$/;
+const keyPattern = /^[a-z][A-Za-z0-9]*$/;
+const slashed = (fileName: string) => fileName.replace(/\\/g, "/");
+
+const refuse = (code: string, input: string, message: string) => ({
+  diagnostics: [{ severity: "error", code, input, message }] satisfies WorkflowDiagnostic[],
+  files: [] as ScaffoldFile[],
+});
+
+export class KeyRename {
+  static async build(workspace: Workspace, input: RenameKeyInput) {
+    const sys = await resolveWorkflowSys(workspace, input.app);
+    if (!sys) return refuse("workflow-target-missing", "app", `No app or library named ${input.app ?? ""}.`);
+    if (!input.module) return refuse("workflow-input-missing", "module", "Module name is required.");
+    if (!input.slice === !input.query)
+      return refuse("rename-key-source-invalid", "slice", "Name exactly one key to rename, as slice or as query.");
+    const family = input.slice ? "slice" : "query";
+    const from = input.slice ?? input.query ?? "";
+    if (!input.to || !keyPattern.test(input.to))
+      return refuse(
+        "rename-key-name-invalid",
+        "to",
+        `New key "${input.to ?? ""}" must be camelCase (inFeed, byTitle).`,
+      );
+    if (input.to === from) return refuse("rename-key-name-same", "to", `New key is the same as ${from}.`);
+
+    const root = workspace.workspaceRoot;
+    const paths = moduleSourcePaths(input.module);
+    const sourceRelative = `${getSysRoot(sys)}/${family === "slice" ? paths.signal : paths.document}`;
+    const sourcePath = slashed(path.join(root, sourceRelative));
+    const texts = new Map<string, string>();
+    const index = new AkanIndex({ ts, root });
+    for (const relative of await workspace.getAllFiles("{apps,libs}/**/*.{ts,tsx}")) {
+      if (!indexedPath.test(slashed(relative))) continue;
+      const fileName = slashed(path.join(root, relative));
+      const text = await readFile(fileName, "utf8");
+      texts.set(fileName, text);
+      index.setFile(fileName, text);
+    }
+
+    const keys = index.sourceKeysOf(sourcePath).filter((key) => key.family === family);
+    const source = keys.find((key) => key.sourceKey === from);
+    if (!source)
+      return refuse("rename-key-source-missing", family, `${sourceRelative} declares no ${family} key ${from}.`);
+    if (keys.some((key) => key.sourceKey === input.to))
+      return refuse("rename-key-exists", "to", `${sourceRelative} already declares the ${family} key ${input.to}.`);
+    const edits = index.renameAt(sourcePath, source.span.start, input.to, (fileName) => texts.get(fileName)) ?? [];
+
+    const byFile = new Map<string, AkanRenameEdit[]>();
+    for (const edit of edits) byFile.set(edit.span.fileName, [...(byFile.get(edit.span.fileName) ?? []), edit]);
+    const files: ScaffoldFile[] = [...byFile].map(([fileName, fileEdits]) => {
+      let content = texts.get(fileName) ?? "";
+      for (const { span, newText } of fileEdits.toSorted((a, b) => b.span.start - a.span.start))
+        content = content.slice(0, span.start) + newText + content.slice(span.end);
+      const names = fileEdits.length === 1 ? "1 name changes" : `${fileEdits.length} names change`;
+      return {
+        path: slashed(path.relative(root, fileName)),
+        content,
+        action: "modify",
+        reason: `${names} with the ${family} key ${from} → ${input.to}.`,
+      };
+    });
+    return { diagnostics: [] as WorkflowDiagnostic[], files: files.toSorted((a, b) => a.path.localeCompare(b.path)) };
+  }
+
+  static targetsOf(files: readonly { path: string }[]) {
+    return [...new Set(files.map((file) => file.path.split("/").slice(0, 2).join("/")))];
+  }
+}

package/workflow/plan.ts

@@ -3,6 +3,7 @@ import type { Workspace } from "../commandDecorators";
 import { workflowPlanApproval } from "./artifacts";
 import { resolveWorkflowSys } from "./executor";
 import { InteractionScaffold } from "./interactionScaffold";
+import { KeyRename } from "./keyRename";
 import { MutationScaffold } from "./mutationScaffold";
 import { coerceFieldDefault, moduleSourcePaths } from "./source";
 import type {
@@ -28,6 +29,8 @@ const nameInputPatterns: Record<string, RegExp> = {
   scalar: identifierPattern,
   field: identifierPattern,
   slice: identifierPattern,
+  query: identifierPattern,
+  to: identifierPattern,
   mutation: identifierPattern,
   interaction: identifierPattern,
 };
@@ -458,7 +461,26 @@ const planString = (inputs: Record<string, WorkflowInputValue>, name: string) =>
 const planStrings = (inputs: Record<string, WorkflowInputValue>, name: string) =>
   Array.isArray(inputs[name]) ? inputs[name] : null;
 
+const inspectRenameKeyPlan = async (workspace: Workspace, plan: WorkflowPlan): Promise<WorkflowPlan> => {
+  if (plan.diagnostics.some((diagnostic) => diagnostic.severity === "error")) return plan;
+  const { diagnostics, files } = await KeyRename.build(workspace, {
+    app: planString(plan.inputs, "app"),
+    module: planString(plan.inputs, "module"),
+    slice: planString(plan.inputs, "slice"),
+    query: planString(plan.inputs, "query"),
+    to: planString(plan.inputs, "to"),
+  });
+  return {
+    ...plan,
+    diagnostics: [...plan.diagnostics, ...diagnostics],
+    predictedChanges: files.length
+      ? files.map((file) => ({ target: file.path, action: "modify", applyScope: "auto", reason: file.reason }))
+      : plan.predictedChanges,
+  };
+};
+
 export const inspectWorkflowPlan = async (workspace: Workspace, plan: WorkflowPlan): Promise<WorkflowPlan> => {
+  if (plan.workflow === "rename-key") return await inspectRenameKeyPlan(workspace, plan);
   if (plan.workflow !== "add-mutation" && plan.workflow !== "create-interaction") return plan;
   const app = planString(plan.inputs, "app");
   if (!app) return plan;

package/workflow/types.ts

@@ -63,6 +63,12 @@ export interface AddSliceInput extends PrimitiveTargetInput {
   slice: string | null;
 }
 
+export interface RenameKeyInput extends PrimitiveTargetInput {
+  slice: string | null;
+  query: string | null;
+  to: string | null;
+}
+
 export interface WorkflowInputSpec {
   type: WorkflowInputType;
   required?: boolean;
@@ -498,5 +504,6 @@ export interface WorkflowPrimitiveOperations {
   addEnumField: (input: AddEnumFieldInput) => Promise<PrimitiveWriteReport>;
   addMutation: (input: AddMutationInput) => Promise<PrimitiveWriteReport>;
   addSlice: (input: AddSliceInput) => Promise<PrimitiveWriteReport>;
+  renameKey: (input: RenameKeyInput) => Promise<PrimitiveWriteReport>;
   createInteraction: (input: CreateInteractionInput) => Promise<PrimitiveWriteReport>;
 }