@akanjs/cli 2.3.9-rc.1 → 2.3.9-rc.2

package/incrementalBuilder.proc.js

@@ -2809,7 +2809,7 @@ class Executor {
     this.logger.verbose(`Remove directory ${readPath}`);
     return this;
   }
-  async writeFile(filePath, content, { overwrite = true } = {}) {
+  async writeFile(filePath, content, { overwrite = true, silent = false } = {}) {
     const writePath = this.getPath(filePath);
     const dir = path7.dirname(writePath);
     if (!await FileSys.dirExists(dir))
@@ -2827,7 +2827,8 @@ class Executor {
       }
     } else {
       await FileSys.writeText(writePath, contentStr);
-      this.logger.rawLog(chalk4.green(`File Create: ${filePath}`));
+      if (!silent)
+        this.logger.rawLog(chalk4.green(`File Create: ${filePath}`));
     }
     return { filePath: writePath, content: contentStr };
   }
@@ -3491,14 +3492,15 @@ class AppExecutor extends SysExecutor {
   getCommandEnv(env = {}) {
     const basePort = 8282;
     const portOffset = WorkspaceExecutor.getBaseDevEnv().portOffset;
-    const PORT = basePort ? (basePort + portOffset).toString() : undefined;
+    const PORT = (basePort + portOffset).toString();
     const AKAN_PUBLIC_SERVER_PORT = portOffset ? (8282 + portOffset).toString() : undefined;
     return {
       ...process.env,
       AKAN_PUBLIC_APP_NAME: this.name,
       AKAN_WORKSPACE_ROOT: this.workspace.workspaceRoot,
       NODE_NO_WARNINGS: "1",
-      ...PORT ? { PORT, AKAN_PUBLIC_CLIENT_PORT: PORT } : {},
+      PORT,
+      AKAN_PUBLIC_CLIENT_PORT: PORT,
       ...AKAN_PUBLIC_SERVER_PORT ? { AKAN_PUBLIC_SERVER_PORT } : {},
       ...env
     };
@@ -11886,6 +11888,15 @@ var createWorkflowPlan = (spec, rawInputs) => {
     }
     inputs[name] = value;
   }
+  const fieldType = inputs.type;
+  if (spec.name === "add-field" && typeof fieldType === "string" && (fieldType.toLowerCase() === "number" || fieldType.toLowerCase() === "numeric")) {
+    diagnostics.push({
+      severity: "error",
+      code: "primitive-field-type-unsupported",
+      input: "type",
+      message: `Field type "${fieldType}" is ambiguous in Akan. Use Int for integer fields or Float for decimal fields.`
+    });
+  }
   return {
     schemaVersion: 1,
     workflow: spec.name,
@@ -11971,29 +11982,37 @@ var createWorkflowApplyReport = ({
   mode,
   changedFiles = [],
   generatedFiles: generatedFiles2 = [],
+  appliedCommands = [],
+  recommendedValidationCommands,
   commands = [],
   diagnostics = [],
   nextActions = [],
   plan
-}) => ({
-  schemaVersion: 1,
-  workflow,
-  mode,
-  status: workflowStatus(diagnostics),
-  changedFiles: uniqueBy(changedFiles, (file) => `${file.action}:${file.path}:${file.reason}`),
-  generatedFiles: uniqueBy(generatedFiles2, (file) => `${file.action}:${file.path}:${file.reason}`),
-  commands: uniqueBy(commands, (command3) => command3.command),
-  diagnostics,
-  nextActions: uniqueBy(nextActions, (action) => action.command),
-  plan
-});
+}) => {
+  const validationCommands2 = recommendedValidationCommands ?? commands;
+  return {
+    schemaVersion: 1,
+    workflow,
+    mode,
+    status: workflowStatus(diagnostics),
+    changedFiles: uniqueBy(changedFiles, (file) => `${file.action}:${file.path}:${file.reason}`),
+    generatedFiles: uniqueBy(generatedFiles2, (file) => `${file.action}:${file.path}:${file.reason}`),
+    appliedCommands: uniqueBy(appliedCommands, (command3) => command3.command),
+    recommendedValidationCommands: uniqueBy(validationCommands2, (command3) => command3.command),
+    commands: uniqueBy(validationCommands2, (command3) => command3.command),
+    diagnostics,
+    nextActions: uniqueBy(nextActions, (action) => action.command),
+    plan
+  };
+};
 var resolveWorkflowCommand = (command3, plan) => {
   const target = typeof plan.inputs.app === "string" ? plan.inputs.app : "<app-or-lib>";
   return command3.replaceAll("<app-or-lib-or-pkg>", target).replaceAll("<app-or-lib>", target).replaceAll("<app-name>", target);
 };
 var workflowCommandsForPlan = (plan) => plan.validation.map((validation) => ({
   command: resolveWorkflowCommand(validation.command, plan),
-  reason: validation.reason
+  reason: validation.reason,
+  kind: validation.kind
 }));
 var workflowRunsDir = ".akan/workflows/runs";
 var createWorkflowRunId = (prefix = "run") => `${prefix}-${new Date().toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}-${Math.random().toString(36).slice(2, 8)}`;
@@ -12006,7 +12025,7 @@ var workflowRunArtifactPath = (runId) => `${workflowRunsDir}/${runId}.json`;
 var writeWorkflowRunArtifact = async (workspace, artifact) => {
   const runId = getRunId(artifact);
   const artifactPath = workflowRunArtifactPath(runId);
-  await workspace.writeFile(artifactPath, jsonText(artifact));
+  await workspace.writeFile(artifactPath, jsonText(artifact), { silent: true });
   return { runId, path: artifactPath };
 };
 var readWorkflowRunArtifact = async (workspace, runId) => {
@@ -12033,7 +12052,10 @@ var createWorkflowValidationRunReport = async ({
     {
       severity: "error",
       code: "workflow-validation-command-failed",
-      message: `Validation command failed: ${result.command}`
+      message: `Validation command failed: ${result.command}`,
+      command: result.command,
+      kind: result.kind,
+      failureScope: result.failureScope
     }
   ] : []);
   return {
@@ -12216,8 +12238,11 @@ var renderWorkflowApplyReport = (report) => [
   "## Generated Files",
   ...report.generatedFiles.length ? report.generatedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
   "",
-  "## Commands",
-  ...report.commands.length ? report.commands.map((command3) => `- \`${command3.command}\`: ${command3.reason}`) : ["- none"],
+  "## Applied Commands",
+  ...report.appliedCommands.length ? report.appliedCommands.map((command3) => `- \`${command3.command}\`: ${command3.reason}`) : ["- none"],
+  "",
+  "## Recommended Validation Commands",
+  ...report.recommendedValidationCommands.length ? report.recommendedValidationCommands.map((command3) => `- \`${command3.command}\`: ${command3.reason}`) : ["- none"],
   "",
   "## Diagnostics",
   ...report.diagnostics.length ? report.diagnostics.map((diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`) : ["- none"],
@@ -12235,7 +12260,10 @@ var renderWorkflowValidationRunReport = (report) => [
   `- Status: ${report.status}`,
   "",
   "## Commands",
-  ...report.commands.length ? report.commands.map((command3) => `- [${command3.status}] \`${command3.command}\`: ${command3.reason}`) : ["- none"],
+  ...report.commands.length ? report.commands.map((command3) => {
+    const scope = command3.failureScope ? ` (${command3.failureScope})` : "";
+    return `- [${command3.status}] \`${command3.command}\`${scope}: ${command3.reason}`;
+  }) : ["- none"],
   "",
   "## Diagnostics",
   ...report.diagnostics.length ? report.diagnostics.map((diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`) : ["- none"],
@@ -12305,7 +12333,7 @@ class WorkflowExecutor {
   async apply(plan) {
     const changedFiles = [];
     const generatedFiles2 = [];
-    const commands = [];
+    const recommendedValidationCommands = [];
     const diagnostics = [...plan.diagnostics];
     const nextActions = [];
     if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
@@ -12314,13 +12342,13 @@ class WorkflowExecutor {
         mode: "apply",
         changedFiles,
         generatedFiles: generatedFiles2,
-        commands,
+        recommendedValidationCommands,
         diagnostics,
         nextActions,
         plan
       });
     }
-    commands.push(...workflowCommandsForPlan(plan));
+    recommendedValidationCommands.push(...workflowCommandsForPlan(plan));
     nextActions.push(...workflowCommandsForPlan(plan));
     for (const step of plan.steps) {
       const runner2 = this.registry[workflowStepKey(plan.workflow, step.id)] ?? this.registry[step.tool] ?? this.registry[step.id];
@@ -12341,7 +12369,7 @@ class WorkflowExecutor {
         continue;
       changedFiles.push(...result.changedFiles ?? []);
       generatedFiles2.push(...result.generatedFiles ?? []);
-      commands.push(...result.commands ?? []);
+      recommendedValidationCommands.push(...result.commands ?? []);
       diagnostics.push(...result.diagnostics ?? []);
       nextActions.push(...result.nextActions ?? []);
       if (diagnostics.some((diagnostic) => diagnostic.severity === "error"))
@@ -12352,7 +12380,7 @@ class WorkflowExecutor {
       mode: "apply",
       changedFiles,
       generatedFiles: generatedFiles2,
-      commands,
+      recommendedValidationCommands,
       diagnostics,
       nextActions,
       plan
@@ -12438,14 +12466,34 @@ var scalarChangedFiles = (sys3, scalarName, files) => Object.values(files).map((
 var titleize = (value) => value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
 var lowerlize = (value) => `${value.slice(0, 1).toLowerCase()}${value.slice(1)}`;
 var compactDiagnostics = (diagnostics) => diagnostics.filter((diagnostic) => !!diagnostic);
-var fieldExpression = (typeName, defaultValue) => {
+var normalizeFieldType = (typeName) => {
   const normalizedTypes = {
     string: "String",
-    number: "Number",
     boolean: "Boolean",
-    date: "Date"
+    date: "Date",
+    int: "Int",
+    integer: "Int",
+    float: "Float",
+    double: "Float",
+    decimal: "Float"
   };
-  const typeExpression = normalizedTypes[typeName.toLowerCase()] ?? typeName;
+  return normalizedTypes[typeName.toLowerCase()] ?? typeName;
+};
+var ensureBaseTypeImport = (content, typeName) => {
+  if (typeName !== "Int" && typeName !== "Float")
+    return content;
+  if (new RegExp(`import \\{[^}]*\\b${typeName}\\b[^}]*\\} from "akanjs/base";`).test(content))
+    return content;
+  const baseImport = /import \{ ([^}]+) \} from "akanjs\/base";/.exec(content);
+  if (baseImport) {
+    const names = baseImport[1].split(",").map((name) => name.trim()).filter(Boolean);
+    return content.replace(baseImport[0], `import { ${[...names, typeName].sort().join(", ")} } from "akanjs/base";`);
+  }
+  return `import { ${typeName} } from "akanjs/base";
+${content}`;
+};
+var fieldExpression = (typeName, defaultValue) => {
+  const typeExpression = normalizeFieldType(typeName);
   const defaultOption = defaultValue ? `, { default: ${JSON.stringify(defaultValue)} }` : "";
   return `field(${typeExpression}${defaultOption})`;
 };

package/index.js

@@ -2807,7 +2807,7 @@ class Executor {
     this.logger.verbose(`Remove directory ${readPath}`);
     return this;
   }
-  async writeFile(filePath, content, { overwrite = true } = {}) {
+  async writeFile(filePath, content, { overwrite = true, silent = false } = {}) {
     const writePath = this.getPath(filePath);
     const dir = path7.dirname(writePath);
     if (!await FileSys.dirExists(dir))
@@ -2825,7 +2825,8 @@ class Executor {
       }
     } else {
       await FileSys.writeText(writePath, contentStr);
-      this.logger.rawLog(chalk4.green(`File Create: ${filePath}`));
+      if (!silent)
+        this.logger.rawLog(chalk4.green(`File Create: ${filePath}`));
     }
     return { filePath: writePath, content: contentStr };
   }
@@ -3489,14 +3490,15 @@ class AppExecutor extends SysExecutor {
   getCommandEnv(env = {}) {
     const basePort = 8282;
     const portOffset = WorkspaceExecutor.getBaseDevEnv().portOffset;
-    const PORT = basePort ? (basePort + portOffset).toString() : undefined;
+    const PORT = (basePort + portOffset).toString();
     const AKAN_PUBLIC_SERVER_PORT = portOffset ? (8282 + portOffset).toString() : undefined;
     return {
       ...process.env,
       AKAN_PUBLIC_APP_NAME: this.name,
       AKAN_WORKSPACE_ROOT: this.workspace.workspaceRoot,
       NODE_NO_WARNINGS: "1",
-      ...PORT ? { PORT, AKAN_PUBLIC_CLIENT_PORT: PORT } : {},
+      PORT,
+      AKAN_PUBLIC_CLIENT_PORT: PORT,
       ...AKAN_PUBLIC_SERVER_PORT ? { AKAN_PUBLIC_SERVER_PORT } : {},
       ...env
     };
@@ -11884,6 +11886,15 @@ var createWorkflowPlan = (spec, rawInputs) => {
     }
     inputs[name] = value;
   }
+  const fieldType = inputs.type;
+  if (spec.name === "add-field" && typeof fieldType === "string" && (fieldType.toLowerCase() === "number" || fieldType.toLowerCase() === "numeric")) {
+    diagnostics.push({
+      severity: "error",
+      code: "primitive-field-type-unsupported",
+      input: "type",
+      message: `Field type "${fieldType}" is ambiguous in Akan. Use Int for integer fields or Float for decimal fields.`
+    });
+  }
   return {
     schemaVersion: 1,
     workflow: spec.name,
@@ -11969,29 +11980,37 @@ var createWorkflowApplyReport = ({
   mode,
   changedFiles = [],
   generatedFiles: generatedFiles2 = [],
+  appliedCommands = [],
+  recommendedValidationCommands,
   commands = [],
   diagnostics = [],
   nextActions = [],
   plan
-}) => ({
-  schemaVersion: 1,
-  workflow,
-  mode,
-  status: workflowStatus(diagnostics),
-  changedFiles: uniqueBy(changedFiles, (file) => `${file.action}:${file.path}:${file.reason}`),
-  generatedFiles: uniqueBy(generatedFiles2, (file) => `${file.action}:${file.path}:${file.reason}`),
-  commands: uniqueBy(commands, (command3) => command3.command),
-  diagnostics,
-  nextActions: uniqueBy(nextActions, (action) => action.command),
-  plan
-});
+}) => {
+  const validationCommands2 = recommendedValidationCommands ?? commands;
+  return {
+    schemaVersion: 1,
+    workflow,
+    mode,
+    status: workflowStatus(diagnostics),
+    changedFiles: uniqueBy(changedFiles, (file) => `${file.action}:${file.path}:${file.reason}`),
+    generatedFiles: uniqueBy(generatedFiles2, (file) => `${file.action}:${file.path}:${file.reason}`),
+    appliedCommands: uniqueBy(appliedCommands, (command3) => command3.command),
+    recommendedValidationCommands: uniqueBy(validationCommands2, (command3) => command3.command),
+    commands: uniqueBy(validationCommands2, (command3) => command3.command),
+    diagnostics,
+    nextActions: uniqueBy(nextActions, (action) => action.command),
+    plan
+  };
+};
 var resolveWorkflowCommand = (command3, plan) => {
   const target = typeof plan.inputs.app === "string" ? plan.inputs.app : "<app-or-lib>";
   return command3.replaceAll("<app-or-lib-or-pkg>", target).replaceAll("<app-or-lib>", target).replaceAll("<app-name>", target);
 };
 var workflowCommandsForPlan = (plan) => plan.validation.map((validation) => ({
   command: resolveWorkflowCommand(validation.command, plan),
-  reason: validation.reason
+  reason: validation.reason,
+  kind: validation.kind
 }));
 var workflowRunsDir = ".akan/workflows/runs";
 var createWorkflowRunId = (prefix = "run") => `${prefix}-${new Date().toISOString().replace(/[-:.TZ]/g, "").slice(0, 14)}-${Math.random().toString(36).slice(2, 8)}`;
@@ -12004,7 +12023,7 @@ var workflowRunArtifactPath = (runId) => `${workflowRunsDir}/${runId}.json`;
 var writeWorkflowRunArtifact = async (workspace, artifact) => {
   const runId = getRunId(artifact);
   const artifactPath = workflowRunArtifactPath(runId);
-  await workspace.writeFile(artifactPath, jsonText(artifact));
+  await workspace.writeFile(artifactPath, jsonText(artifact), { silent: true });
   return { runId, path: artifactPath };
 };
 var readWorkflowRunArtifact = async (workspace, runId) => {
@@ -12031,7 +12050,10 @@ var createWorkflowValidationRunReport = async ({
     {
       severity: "error",
       code: "workflow-validation-command-failed",
-      message: `Validation command failed: ${result.command}`
+      message: `Validation command failed: ${result.command}`,
+      command: result.command,
+      kind: result.kind,
+      failureScope: result.failureScope
     }
   ] : []);
   return {
@@ -12214,8 +12236,11 @@ var renderWorkflowApplyReport = (report) => [
   "## Generated Files",
   ...report.generatedFiles.length ? report.generatedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
   "",
-  "## Commands",
-  ...report.commands.length ? report.commands.map((command3) => `- \`${command3.command}\`: ${command3.reason}`) : ["- none"],
+  "## Applied Commands",
+  ...report.appliedCommands.length ? report.appliedCommands.map((command3) => `- \`${command3.command}\`: ${command3.reason}`) : ["- none"],
+  "",
+  "## Recommended Validation Commands",
+  ...report.recommendedValidationCommands.length ? report.recommendedValidationCommands.map((command3) => `- \`${command3.command}\`: ${command3.reason}`) : ["- none"],
   "",
   "## Diagnostics",
   ...report.diagnostics.length ? report.diagnostics.map((diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`) : ["- none"],
@@ -12233,7 +12258,10 @@ var renderWorkflowValidationRunReport = (report) => [
   `- Status: ${report.status}`,
   "",
   "## Commands",
-  ...report.commands.length ? report.commands.map((command3) => `- [${command3.status}] \`${command3.command}\`: ${command3.reason}`) : ["- none"],
+  ...report.commands.length ? report.commands.map((command3) => {
+    const scope = command3.failureScope ? ` (${command3.failureScope})` : "";
+    return `- [${command3.status}] \`${command3.command}\`${scope}: ${command3.reason}`;
+  }) : ["- none"],
   "",
   "## Diagnostics",
   ...report.diagnostics.length ? report.diagnostics.map((diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`) : ["- none"],
@@ -12303,7 +12331,7 @@ class WorkflowExecutor {
   async apply(plan) {
     const changedFiles = [];
     const generatedFiles2 = [];
-    const commands = [];
+    const recommendedValidationCommands = [];
     const diagnostics = [...plan.diagnostics];
     const nextActions = [];
     if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
@@ -12312,13 +12340,13 @@ class WorkflowExecutor {
         mode: "apply",
         changedFiles,
         generatedFiles: generatedFiles2,
-        commands,
+        recommendedValidationCommands,
         diagnostics,
         nextActions,
         plan
       });
     }
-    commands.push(...workflowCommandsForPlan(plan));
+    recommendedValidationCommands.push(...workflowCommandsForPlan(plan));
     nextActions.push(...workflowCommandsForPlan(plan));
     for (const step of plan.steps) {
       const runner2 = this.registry[workflowStepKey(plan.workflow, step.id)] ?? this.registry[step.tool] ?? this.registry[step.id];
@@ -12339,7 +12367,7 @@ class WorkflowExecutor {
         continue;
       changedFiles.push(...result.changedFiles ?? []);
       generatedFiles2.push(...result.generatedFiles ?? []);
-      commands.push(...result.commands ?? []);
+      recommendedValidationCommands.push(...result.commands ?? []);
       diagnostics.push(...result.diagnostics ?? []);
       nextActions.push(...result.nextActions ?? []);
       if (diagnostics.some((diagnostic) => diagnostic.severity === "error"))
@@ -12350,7 +12378,7 @@ class WorkflowExecutor {
       mode: "apply",
       changedFiles,
       generatedFiles: generatedFiles2,
-      commands,
+      recommendedValidationCommands,
       diagnostics,
       nextActions,
       plan
@@ -12436,14 +12464,34 @@ var scalarChangedFiles = (sys3, scalarName, files) => Object.values(files).map((
 var titleize = (value) => value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
 var lowerlize = (value) => `${value.slice(0, 1).toLowerCase()}${value.slice(1)}`;
 var compactDiagnostics = (diagnostics) => diagnostics.filter((diagnostic) => !!diagnostic);
-var fieldExpression = (typeName, defaultValue) => {
+var normalizeFieldType = (typeName) => {
   const normalizedTypes = {
     string: "String",
-    number: "Number",
     boolean: "Boolean",
-    date: "Date"
+    date: "Date",
+    int: "Int",
+    integer: "Int",
+    float: "Float",
+    double: "Float",
+    decimal: "Float"
   };
-  const typeExpression = normalizedTypes[typeName.toLowerCase()] ?? typeName;
+  return normalizedTypes[typeName.toLowerCase()] ?? typeName;
+};
+var ensureBaseTypeImport = (content, typeName) => {
+  if (typeName !== "Int" && typeName !== "Float")
+    return content;
+  if (new RegExp(`import \\{[^}]*\\b${typeName}\\b[^}]*\\} from "akanjs/base";`).test(content))
+    return content;
+  const baseImport = /import \{ ([^}]+) \} from "akanjs\/base";/.exec(content);
+  if (baseImport) {
+    const names = baseImport[1].split(",").map((name) => name.trim()).filter(Boolean);
+    return content.replace(baseImport[0], `import { ${[...names, typeName].sort().join(", ")} } from "akanjs/base";`);
+  }
+  return `import { ${typeName} } from "akanjs/base";
+${content}`;
+};
+var fieldExpression = (typeName, defaultValue) => {
+  const typeExpression = normalizeFieldType(typeName);
   const defaultOption = defaultValue ? `, { default: ${JSON.stringify(defaultValue)} }` : "";
   return `field(${typeExpression}${defaultOption})`;
 };
@@ -14194,6 +14242,9 @@ class CloudCommand extends command("cloud", [CloudScript], ({ public: target })
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger as Logger17 } from "akanjs/common";
 
+// pkgs/@akanjs/cli/context/context.runner.ts
+import path43 from "path";
+
 // pkgs/@akanjs/cli/module/module.script.ts
 import { input as input6 } from "@inquirer/prompts";
 import { capitalize as capitalize8, randomPicks } from "akanjs/common";
@@ -14833,6 +14884,8 @@ class PrimitiveScript extends script("primitive", [ModuleScript]) {
   }
   async addFieldToSources(workspace, input7, { enumValues }) {
     const sys3 = await this.resolveSys(workspace, input7.app);
+    const ambiguousNumberTypes = new Set(["number", "numeric"]);
+    const normalizedType = input7.type ? normalizeFieldType(input7.type) : null;
     const diagnostics = compactDiagnostics([
       !sys3 && { severity: "error", code: "primitive-target-missing", message: "Target app or library was not found." },
       !input7.module && {
@@ -14853,7 +14906,13 @@ class PrimitiveScript extends script("primitive", [ModuleScript]) {
         message: "Type is required.",
         input: "type"
       },
-      enumValues && enumValues.length === 0 ? { severity: "error", code: "primitive-input-missing", message: "Enum values are required.", input: "values" } : null
+      enumValues && enumValues.length === 0 ? { severity: "error", code: "primitive-input-missing", message: "Enum values are required.", input: "values" } : null,
+      input7.type && ambiguousNumberTypes.has(input7.type.toLowerCase()) ? {
+        severity: "error",
+        code: "primitive-field-type-unsupported",
+        message: `Field type "${input7.type}" is ambiguous in Akan. Use Int for integer fields or Float for decimal fields.`,
+        input: "type"
+      } : null
     ]);
     if (!sys3 || !input7.module || !input7.field || !input7.type || diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
       return createPrimitiveWriteReport({
@@ -14923,6 +14982,10 @@ class PrimitiveScript extends script("primitive", [ModuleScript]) {
         dictionaryContent = enumDictionary;
       }
     }
+    if (!enumValues && normalizedType) {
+      input7.type = normalizedType;
+      constantContent = ensureBaseTypeImport(constantContent, input7.type);
+    }
     const nextConstantContent = insertIntoObject(constantContent, inputClassName, `${input7.field}: ${fieldExpression(input7.type, input7.defaultValue)},`);
     const nextDictionaryContent = insertDictionaryModelField(dictionaryContent, moduleClassName, input7.field);
     if (!nextConstantContent) {
@@ -15310,8 +15373,12 @@ var moduleInput = {
   }
 };
 var baseValidation = [
-  { command: "akan sync <app-or-lib>", reason: "Refresh generated Akan files from source conventions." },
-  { command: "akan lint <app-or-lib-or-pkg>", reason: "Validate formatting, imports, and static lint rules." }
+  { command: "akan sync <app-or-lib>", reason: "Refresh generated Akan files from source conventions.", kind: "sync" },
+  {
+    command: "akan lint <app-or-lib-or-pkg>",
+    reason: "Validate formatting, imports, and static lint rules.",
+    kind: "lint"
+  }
 ];
 
 // pkgs/@akanjs/cli/workflows/addEnumField.ts
@@ -15381,7 +15448,7 @@ var addEnumFieldWorkflowSpec = {
   ],
   validation: [
     ...baseValidation,
-    { command: "akan typecheck <app-name>", reason: "Validate enum usage across module surfaces." }
+    { command: "akan typecheck <app-name>", reason: "Validate enum usage across module surfaces.", kind: "typecheck" }
   ],
   completionCriteria: ["Enum values are represented.", "Labels and options exist.", "Sync, lint, and typecheck pass."]
 };
@@ -15396,7 +15463,11 @@ var addFieldWorkflowSpec = {
     ...sysInputs,
     ...moduleInput,
     field: { type: "string", required: true, description: "Name of the field to add." },
-    type: { type: "string", required: true, description: "Field type or scalar name." },
+    type: {
+      type: "string",
+      required: true,
+      description: "Field type or scalar name. Use Int for integer fields or Float for decimal fields; do not use Number."
+    },
     values: { type: "string-list", description: "Comma-separated enum values when type is enum." },
     default: { type: "string", description: "Optional default value for the field." }
   },
@@ -15461,7 +15532,8 @@ var addFieldWorkflowSpec = {
     ...baseValidation,
     {
       command: "akan typecheck <app-name>",
-      reason: "Validate cross-surface TypeScript contracts after field changes."
+      reason: "Validate cross-surface TypeScript contracts after field changes.",
+      kind: "typecheck"
     }
   ],
   completionCriteria: [
@@ -15538,7 +15610,11 @@ var addMutationWorkflowSpec = {
   ],
   validation: [
     ...baseValidation,
-    { command: "akan typecheck <app-name>", reason: "Validate mutation contracts across service and signal." }
+    {
+      command: "akan typecheck <app-name>",
+      reason: "Validate mutation contracts across service and signal.",
+      kind: "typecheck"
+    }
   ],
   completionCriteria: ["Service and signal contracts align.", "Generated files are refreshed.", "Validation passes."]
 };
@@ -15609,7 +15685,8 @@ var addSliceWorkflowSpec = {
     ...baseValidation,
     {
       command: "akan build <app-name>",
-      reason: "Validate page and list surfaces when a slice changes app behavior."
+      reason: "Validate page and list surfaces when a slice changes app behavior.",
+      kind: "custom"
     }
   ],
   completionCriteria: [
@@ -15828,7 +15905,36 @@ var failedApplyReport = (workflow2, diagnostics, plan) => createWorkflowApplyRep
   plan: plan ?? failedPlan(workflow2, diagnostics)
 });
 var commandForShell2 = (command3) => command3.startsWith("akan ") ? `bun run ${command3}` : command3;
+var inferValidationKind = (command3) => {
+  if (command3.kind)
+    return command3.kind;
+  if (/\bakan\s+sync\b/.test(command3.command))
+    return "sync";
+  if (/\bakan\s+lint\b/.test(command3.command))
+    return "lint";
+  if (/\bakan\s+typecheck\b/.test(command3.command))
+    return "typecheck";
+  if (/\bakan\s+doctor\b/.test(command3.command))
+    return "doctor";
+  return "custom";
+};
+var classifyValidationFailure = (command3, error) => {
+  const output = `${error.stdout ?? ""}
+${error.stderr ?? ""}
+${error.message ?? ""}`.toLowerCase();
+  if (error.code === 127 || output.includes("command not found") || output.includes("bun: command not found")) {
+    return "environment";
+  }
+  if (output.includes("biome.json") || output.includes("biome configuration") || output.includes("configuration file") || output.includes("invalid configuration") || output.includes("failed to load")) {
+    return "workspace-config";
+  }
+  const kind = inferValidationKind(command3);
+  if (kind === "lint" || kind === "typecheck" || kind === "sync")
+    return "source-change";
+  return "unknown";
+};
 var defaultValidationExecutor = (workspace) => async (command3) => {
+  const kind = inferValidationKind(command3);
   try {
     const stdout = await workspace.spawn("bash", ["-lc", commandForShell2(command3.command)], {
       cwd: workspace.workspaceRoot
@@ -15836,6 +15942,7 @@ var defaultValidationExecutor = (workspace) => async (command3) => {
     return {
       command: command3.command,
       reason: command3.reason,
+      kind,
       status: "passed",
       exitCode: 0,
       stdout
@@ -15845,8 +15952,10 @@ var defaultValidationExecutor = (workspace) => async (command3) => {
     return {
       command: command3.command,
       reason: command3.reason,
+      kind,
       status: "failed",
       exitCode: commandError.code ?? 1,
+      failureScope: classifyValidationFailure(command3, commandError),
       stdout: commandError.stdout,
       stderr: commandError.stderr ?? commandError.message
     };
@@ -16060,6 +16169,21 @@ var stringProperty = { type: "string" };
 var booleanProperty = { type: "boolean" };
 var objectProperty = { type: "object", additionalProperties: true };
 var parseJsonOutput = (output) => JSON.parse(output);
+var slugPart = (value) => typeof value === "string" ? value.trim().replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase() : "";
+var defaultWorkflowPlanPath = (workflow2, inputs) => {
+  const slug = [
+    slugPart(workflow2),
+    slugPart(inputs.app),
+    slugPart(inputs.module),
+    slugPart(inputs.field),
+    slugPart(inputs.scalar),
+    slugPart(inputs.surface),
+    slugPart(inputs.mutation),
+    slugPart(inputs.slice)
+  ].filter(Boolean).join("-");
+  return `.akan/workflows/plans/${slug || "workflow-plan"}.json`;
+};
+var workspacePath = (workspace, filePath) => path43.isAbsolute(filePath) ? filePath : path43.join(workspace.workspaceRoot, filePath);
 var stringArg = (args, key) => {
   const value = args[key];
   if (typeof value !== "string" || !value)
@@ -16112,7 +16236,7 @@ var planMcpTools = [
     name: "plan_workflow",
     inputSchema: {
       type: "object",
-      properties: { workflow: stringProperty, inputs: objectProperty },
+      properties: { workflow: stringProperty, inputs: objectProperty, out: stringProperty },
       required: ["workflow"]
     }
   }
@@ -16238,6 +16362,8 @@ class ContextRunner extends runner("context") {
           "akan workflow report <run-id> --format json",
           "akan doctor --strict --format json"
         ],
+        validationFailureScopes: ["workspace-config", "environment", "source-change", "unknown"],
+        applyReportFields: ["appliedCommands", "recommendedValidationCommands", "commands"],
         repairCommands: [
           "akan repair generated --app <app-or-lib> --format json",
           "akan repair format --target <app-or-lib-or-pkg> --format json",
@@ -16250,18 +16376,27 @@ class ContextRunner extends runner("context") {
       return parseJsonOutput(new WorkflowRunner().list({ format: "json" }));
     if (name === "explain_workflow")
       return parseJsonOutput(new WorkflowRunner().explain(stringArg(args, "workflow"), { format: "json" }));
-    if (name === "plan_workflow")
-      return parseJsonOutput(await new WorkflowRunner().plan(stringArg(args, "workflow"), workflowInputsArg(args), {
-        format: "json"
+    if (name === "plan_workflow") {
+      const workflow2 = stringArg(args, "workflow");
+      const inputs = workflowInputsArg(args);
+      const planPath = typeof args.out === "string" && args.out ? args.out : defaultWorkflowPlanPath(workflow2, inputs);
+      const plan = parseJsonOutput(await new WorkflowRunner().plan(workflow2, inputs, {
+        format: "json",
+        out: workspacePath(workspace, planPath)
       }));
+      return { ...plan, planPath };
+    }
     if (name === "apply_workflow")
-      return parseJsonOutput(await new WorkflowRunner().apply(stringArg(args, "planPath"), {
+      return parseJsonOutput(await new WorkflowRunner().apply(workspacePath(workspace, stringArg(args, "planPath")), {
         format: "json",
         dryRun: !!args.dryRun,
         registry: createCliWorkflowStepRegistry(workspace)
       }));
     if (name === "run_validation")
-      return parseJsonOutput(await new WorkflowRunner().validate(stringArg(args, "runIdOrPlan"), { format: "json", workspace }));
+      return parseJsonOutput(await new WorkflowRunner().validate(workspacePath(workspace, stringArg(args, "runIdOrPlan")), {
+        format: "json",
+        workspace
+      }));
     if (name === "repair_generated")
       return parseJsonOutput(await new RepairRunner().repair("generated", { workspace, app: stringArg(args, "app"), format: "json" }));
     if (name === "repair_imports")
@@ -16427,7 +16562,7 @@ ${payload}`);
       "create-unit": "`akan create-unit --app <app> --module <module>` creates a module Unit component.",
       "create-template": "`akan create-template --app <app> --module <module>` creates a module Template component.",
       "create-ui": "`akan create-ui --app <app-or-lib> --module <module> --surface <view|unit|template> --format json` creates one UI surface and returns a primitive write report.",
-      "add-field": "`akan add-field --app <app-or-lib> --module <module> --field <field> --type <type> --format json` updates source constant/dictionary files and reports sync/lint next actions.",
+      "add-field": "`akan add-field --app <app-or-lib> --module <module> --field <field> --type <String|Boolean|Date|Int|Float|scalar> --format json` updates source constant/dictionary files. Use Int or Float for numeric fields, not Number.",
       "add-enum-field": "`akan add-enum-field --app <app-or-lib> --module <module> --field <field> --values a,b --format json` adds an enum field to source constant/dictionary files without editing generated files.",
       sync: "`akan sync <app-or-lib>` refreshes generated Akan files from source conventions.",
       lint: "`akan lint <app-or-lib-or-pkg>` runs Biome linting after preparing generated files.",
@@ -16451,6 +16586,7 @@ ${payload}`);
       "repair module-shape": "`akan repair module-shape --app <app-or-lib> --module <module> --format json` reports missing module source files and source-safe next actions.",
       agent: "`akan agent install <target>` writes editor-specific agent rules with overwrite protection.",
       mcp: "`akan mcp --mode readonly|plan|apply` starts the Akan MCP server over stdio with an explicit permission mode.",
+      "mcp-call": '`akan mcp-call <tool> --mode plan --args \'{"workflow":"add-field","inputs":{"app":"demo"}}\'` calls one MCP tool through the same runner path for debugging.',
       "mcp-install": "`akan mcp-install cursor --mode readonly|plan|apply` installs the Akan MCP server config for Cursor."
     };
     return explanations[command3] ?? `No detailed explanation is available for ${command3}. Run \`akan --help\` for command help.`;
@@ -16475,6 +16611,22 @@ class ContextScript extends script("context", [ContextRunner]) {
   async mcp(workspace, { mode = "readonly" } = {}) {
     await this.contextRunner.runMcp(workspace, { mode });
   }
+  async mcpCall(workspace, tool, {
+    mode = "readonly",
+    args = null,
+    format = "json"
+  } = {}) {
+    let parsedArgs = {};
+    if (args) {
+      const parsed = JSON.parse(args);
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("MCP call args must be a JSON object.");
+      }
+      parsedArgs = parsed;
+    }
+    const result = await this.contextRunner.callMcpTool(workspace, tool, parsedArgs, { mode });
+    Logger17.rawLog(format === "json" ? jsonText(result) : String(result));
+  }
 }
 
 // pkgs/@akanjs/cli/context/context.command.ts
@@ -16509,6 +16661,21 @@ class ContextCommand extends command("context", [ContextScript], ({ public: targ
     enum: ["readonly", "plan", "apply"]
   }).with(Workspace).exec(async function(mode, workspace) {
     await this.contextScript.mcp(workspace, { mode });
+  }),
+  mcpCall: target({ desc: "Call one Akan MCP tool for debugging without stdio JSON-RPC" }).arg("tool", String, { desc: "MCP tool name" }).option("mode", String, {
+    desc: "MCP permission mode",
+    default: "readonly",
+    enum: ["readonly", "plan", "apply"]
+  }).option("args", String, { desc: "JSON object to pass as MCP tool arguments", nullable: true }).option("format", String, {
+    desc: "output format",
+    default: "json",
+    enum: ["json"]
+  }).with(Workspace).exec(async function(tool, mode, args, format, workspace) {
+    await this.contextScript.mcpCall(workspace, tool, {
+      mode,
+      args,
+      format
+    });
   })
 })) {
 }
@@ -16537,14 +16704,14 @@ class GuidelinePrompt extends Prompter {
   async#getScanFilePaths(matchPattern, { avoidDirs = ["node_modules", ".next"], filterText } = {}) {
     const glob = new Bun.Glob(matchPattern);
     const paths = [];
-    for await (const path43 of glob.scan({ cwd: this.workspace.workspaceRoot, absolute: true })) {
-      if (avoidDirs.some((dir) => path43.includes(dir)))
+    for await (const path44 of glob.scan({ cwd: this.workspace.workspaceRoot, absolute: true })) {
+      if (avoidDirs.some((dir) => path44.includes(dir)))
         continue;
-      const fileContent = await FileSys.readText(path43);
+      const fileContent = await FileSys.readText(path44);
       const textFilter = filterText ? new RegExp(filterText) : null;
       if (filterText && !textFilter?.test(fileContent))
         continue;
-      paths.push(path43);
+      paths.push(path44);
     }
     return paths;
   }
@@ -16864,7 +17031,7 @@ class LibraryCommand extends command("library", [LibraryScript], ({ public: targ
 
 // pkgs/@akanjs/cli/localRegistry/localRegistry.runner.ts
 import { mkdir as mkdir13, rm as rm6 } from "fs/promises";
-import path43 from "path";
+import path44 from "path";
 import { Logger as Logger19 } from "akanjs/common";
 var defaultLocalRegistryUrl = "http://127.0.0.1:4873";
 var containerName = "akan-verdaccio";
@@ -16882,8 +17049,8 @@ class LocalRegistryRunner extends runner("localRegistry") {
       Logger19.info(`Local registry is already running at ${registry}`);
       return registry;
     } catch {}
-    const configPath2 = path43.join(workspace.workspaceRoot, "pkgs/@akanjs/cli/localRegistry/verdaccio.yaml");
-    const storagePath = path43.join(workspace.workspaceRoot, ".akan/verdaccio/storage");
+    const configPath2 = path44.join(workspace.workspaceRoot, "pkgs/@akanjs/cli/localRegistry/verdaccio.yaml");
+    const storagePath = path44.join(workspace.workspaceRoot, ".akan/verdaccio/storage");
     await mkdir13(storagePath, { recursive: true });
     await workspace.spawn("docker", [
       "run",
@@ -16906,13 +17073,13 @@ class LocalRegistryRunner extends runner("localRegistry") {
     try {
       await workspace.spawn("docker", ["rm", "-f", containerName], { stdio: "inherit" });
     } catch {}
-    await rm6(path43.join(workspace.workspaceRoot, ".akan/verdaccio"), { recursive: true, force: true });
+    await rm6(path44.join(workspace.workspaceRoot, ".akan/verdaccio"), { recursive: true, force: true });
     Logger19.info("Local registry storage has been reset");
   }
   async smoke(workspace, { registryUrl } = {}) {
     const registry = this.getRegistryUrl(registryUrl);
-    const smokeRoot = path43.join(workspace.workspaceRoot, ".akan/e2e");
-    await rm6(path43.join(smokeRoot, smokeRepoName), { recursive: true, force: true });
+    const smokeRoot = path44.join(workspace.workspaceRoot, ".akan/e2e");
+    await rm6(path44.join(smokeRoot, smokeRepoName), { recursive: true, force: true });
     await workspace.spawn(process.execPath, [
       "dist/pkgs/create-akan-workspace/index.js",
       smokeRepoName,
@@ -16929,12 +17096,12 @@ class LocalRegistryRunner extends runner("localRegistry") {
       stdio: "inherit"
     });
     await workspace.spawn("akan", ["typecheck", smokeAppName], {
-      cwd: path43.join(smokeRoot, smokeRepoName),
+      cwd: path44.join(smokeRoot, smokeRepoName),
       env: { ...process.env, AKAN_NPM_REGISTRY: registry, NPM_CONFIG_REGISTRY: registry },
       stdio: "inherit"
     });
     await workspace.spawn("akan", ["build", smokeAppName], {
-      cwd: path43.join(smokeRoot, smokeRepoName),
+      cwd: path44.join(smokeRoot, smokeRepoName),
       env: { ...process.env, AKAN_NPM_REGISTRY: registry, NPM_CONFIG_REGISTRY: registry },
       stdio: "inherit"
     });
@@ -17249,11 +17416,11 @@ class WorkflowCommand extends command("workflow", [WorkflowScript], ({ public: t
 }
 
 // pkgs/@akanjs/cli/workspace/workspace.script.ts
-import path45 from "path";
+import path46 from "path";
 import { Logger as Logger25 } from "akanjs/common";
 
 // pkgs/@akanjs/cli/workspace/workspace.runner.ts
-import path44 from "path";
+import path45 from "path";
 var defaultWorkspacePeerDependencies = new Set([
   "@react-spring/web",
   "@use-gesture/react",
@@ -17304,7 +17471,7 @@ class WorkspaceRunner extends runner("workspace") {
     owner = ""
   }) {
     const cwdPath = process.cwd();
-    const workspaceRoot = path44.join(cwdPath, dirname2, repoName);
+    const workspaceRoot = path45.join(cwdPath, dirname2, repoName);
     const normalizedRegistryUrl = registryUrl ? getNpmRegistryUrl(registryUrl) : undefined;
     const workspace = WorkspaceExecutor.fromRoot({ workspaceRoot, repoName });
     const templateSpinner = workspace.spinning(`Creating workspace template files in ${dirname2}/${repoName}...`);
@@ -17360,9 +17527,9 @@ class WorkspaceRunner extends runner("workspace") {
   }
   async#getCliPackageJson() {
     const packageJsonCandidates = [
-      path44.join(import.meta.dir, "../package.json"),
-      path44.join(import.meta.dir, "package.json"),
-      path44.join(path44.dirname(Bun.main), "package.json")
+      path45.join(import.meta.dir, "../package.json"),
+      path45.join(import.meta.dir, "package.json"),
+      path45.join(path45.dirname(Bun.main), "package.json")
     ];
     try {
       packageJsonCandidates.unshift(Bun.resolveSync("@akanjs/cli/package.json", import.meta.dir));
@@ -17378,9 +17545,9 @@ class WorkspaceRunner extends runner("workspace") {
   }
   async#getAkanPackageJson() {
     const packageJsonCandidates = [
-      path44.join(import.meta.dir, "../../../akanjs/package.json"),
-      path44.join(process.cwd(), "pkgs/akanjs/package.json"),
-      path44.join(path44.dirname(Bun.main), "node_modules/akanjs/package.json")
+      path45.join(import.meta.dir, "../../../akanjs/package.json"),
+      path45.join(process.cwd(), "pkgs/akanjs/package.json"),
+      path45.join(path45.dirname(Bun.main), "node_modules/akanjs/package.json")
     ];
     try {
       packageJsonCandidates.unshift(Bun.resolveSync("akanjs/package.json", import.meta.dir));
@@ -17394,13 +17561,13 @@ class WorkspaceRunner extends runner("workspace") {
     }
     let current = import.meta.dir;
     for (let depth = 0;depth < 6; depth++) {
-      const packageJsonPath = path44.join(current, "package.json");
+      const packageJsonPath = path45.join(current, "package.json");
       if (await Bun.file(packageJsonPath).exists()) {
         const packageJson = await FileSys.readJson(packageJsonPath);
         if (packageJson.name === "akanjs")
           return packageJson;
       }
-      const parent = path44.dirname(current);
+      const parent = path45.dirname(current);
       if (parent === current)
         break;
       current = parent;
@@ -17477,10 +17644,10 @@ class WorkspaceScript extends script("workspace", [
     } catch (_) {
       gitSpinner.fail("Git repository initialization failed. It's not fatal, you can commit manually");
     }
-    const workspacePath = path45.join(dirname2, repoName);
+    const workspacePath2 = path46.join(dirname2, repoName);
     Logger25.rawLog(`
 \uD83C\uDF89 Welcome aboard! Workspace created in ${dirname2}/${repoName}`);
-    Logger25.rawLog(`\uD83D\uDE80 Run \`cd ${workspacePath} && akan start ${appName}\` to start the development server.`);
+    Logger25.rawLog(`\uD83D\uDE80 Run \`cd ${workspacePath2} && akan start ${appName}\` to start the development server.`);
     Logger25.rawLog(`
 \uD83D\uDC4B Happy coding!`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.3.9-rc.1",
+  "version": "2.3.9-rc.2",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.3.9-rc.1",
+    "akanjs": "2.3.9-rc.2",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",

package/templates/workspaceRoot/package.json.template

@@ -8,8 +8,25 @@
     "lint": "akan lint",
     "typecheck": "akan typecheck",
     "test": "akan test",
-    "setup:agent": "akan agent install all",
-    "build": "akan build"
+    "build": "akan build",
+    "setup:agent": "akan agent install all --force",
+    "agent:setup": "akan agent install all --force",
+    "agent:doctor": "akan doctor --strict --format json",
+    "agent:context": "akan context --format json",
+    "agent:mcp:readonly": "akan mcp-install cursor --mode readonly --force",
+    "agent:mcp:plan": "akan mcp-install cursor --mode plan --force",
+    "agent:mcp:apply": "akan mcp-install cursor --mode apply --force",
+    "agent:workflows": "akan workflow list",
+    "agent:sample:context": "akan context --format markdown --app <%= appName %> --module project",
+    "agent:sample:service": "akan create-service billing <%= appName %> --format json",
+    "agent:sample:module": "akan create-module project <%= appName %> --page=true --format json",
+    "agent:sample:field": "akan add-field --app <%= appName %> --module project --field budget --type Int --default 0 --format json",
+    "agent:sample:status": "akan add-enum-field --app <%= appName %> --module project --field status --values draft,active,archived --default draft --format json",
+    "agent:sample:sync": "akan sync <%= appName %>",
+    "agent:sample:check": "akan doctor --strict --format json",
+    "agent:sample:workflow:explain": "akan workflow explain add-field",
+    "agent:sample:workflow:plan": "akan workflow plan add-field --app <%= appName %> --module task --field priority --type enum --values low,medium,high --default medium --format json --out .akan/workflows/plans/task-priority.json",
+    "agent:sample:workflow:dry-run": "akan workflow apply .akan/workflows/plans/task-priority.json --dry-run --format json"
   },
   "dependencies": {},
   "devDependencies": {},