@akanjs/cli 2.3.9-rc.4 → 2.3.9-rc.5

package/incrementalBuilder.proc.js

@@ -3396,28 +3396,28 @@ class SysExecutor extends Executor {
     return scalarModules;
   }
   async getViewComponents() {
-    const viewComponents = (await this.readdir("lib")).filter((name) => !name.startsWith("_") && !name.startsWith("__") && !name.endsWith(".ts")).filter((name) => Bun.file(`${this.cwdPath}/lib/${name}/${name}.View.tsx`).exists());
+    const viewComponents = (await this.readdir("lib")).filter((name) => !name.startsWith("_") && !name.startsWith("__") && !name.endsWith(".ts")).filter((name) => Bun.file(`${this.cwdPath}/lib/${name}/${capitalize(name)}.View.tsx`).exists());
     return viewComponents;
   }
   async getUnitComponents() {
-    const unitComponents = (await this.readdir("lib")).filter((name) => !name.startsWith("_") && !name.startsWith("__") && !name.endsWith(".ts")).filter((name) => Bun.file(`${this.cwdPath}/lib/${name}/${name}.Unit.tsx`).exists());
+    const unitComponents = (await this.readdir("lib")).filter((name) => !name.startsWith("_") && !name.startsWith("__") && !name.endsWith(".ts")).filter((name) => Bun.file(`${this.cwdPath}/lib/${name}/${capitalize(name)}.Unit.tsx`).exists());
     return unitComponents;
   }
   async getTemplateComponents() {
-    const templateComponents = (await this.readdir("lib")).filter((name) => !name.startsWith("_") && !name.startsWith("__") && !name.endsWith(".ts")).filter((name) => Bun.file(`${this.cwdPath}/lib/${name}/${name}.Template.tsx`).exists());
+    const templateComponents = (await this.readdir("lib")).filter((name) => !name.startsWith("_") && !name.startsWith("__") && !name.endsWith(".ts")).filter((name) => Bun.file(`${this.cwdPath}/lib/${name}/${capitalize(name)}.Template.tsx`).exists());
     return templateComponents;
   }
   async getViewsSourceCode() {
     const viewComponents = await this.getViewComponents();
-    return Promise.all(viewComponents.map((viewComponent) => this.getLocalFile(`lib/${viewComponent}/${viewComponent}.View.tsx`)));
+    return Promise.all(viewComponents.map((viewComponent) => this.getLocalFile(`lib/${viewComponent}/${capitalize(viewComponent)}.View.tsx`)));
   }
   async getUnitsSourceCode() {
     const unitComponents = await this.getUnitComponents();
-    return Promise.all(unitComponents.map((unitComponent) => this.getLocalFile(`lib/${unitComponent}/${unitComponent}.Unit.tsx`)));
+    return Promise.all(unitComponents.map((unitComponent) => this.getLocalFile(`lib/${unitComponent}/${capitalize(unitComponent)}.Unit.tsx`)));
   }
   async getTemplatesSourceCode() {
     const templateComponents = await this.getTemplateComponents();
-    return Promise.all(templateComponents.map((templateComponent) => this.getLocalFile(`lib/${templateComponent}/${templateComponent}.Template.tsx`)));
+    return Promise.all(templateComponents.map((templateComponent) => this.getLocalFile(`lib/${templateComponent}/${capitalize(templateComponent)}.Template.tsx`)));
   }
   async getScalarConstantFiles() {
     const scalarModules = await this.getScalarModules();
@@ -4889,6 +4889,12 @@ var statusForScope = (commands, diagnostics, scopes, expectedScope) => {
     return "unknown";
   return hasScopeFailure(scopes, expectedScope, diagnostics) ? "failed" : "passed";
 };
+var statusForValidationKind = (commands, kind) => {
+  const matching = commands.filter((command) => command.kind === kind);
+  if (matching.length === 0)
+    return "unknown";
+  return matching.some((command) => command.status === "failed") ? "failed" : "passed";
+};
 var createKnownBlockers = (commands, diagnostics) => {
   const commandBlockers = commands.filter((command) => command.status === "failed" && (command.failureScope === "workspace-config" || command.failureScope === "environment")).map((command) => ({
     code: `workflow-validation-${command.failureScope}`,
@@ -4922,7 +4928,17 @@ var createValidationStatuses = (commands, diagnostics) => {
   const sourceStatus = statusForScope(commands, diagnostics, scopes, "source-change");
   const workspaceStatus = hasScopeFailure(scopes, "workspace-config", diagnostics) || hasScopeFailure(scopes, "environment", diagnostics) ? "failed" : commands.length || diagnostics.length ? "passed" : "unknown";
   const overallStatus = hasScopeFailure(scopes, "source-change", diagnostics) ? "failed" : hasScopeFailure(scopes, "workspace-config", diagnostics) ? "blocked-by-workspace-config" : hasScopeFailure(scopes, "environment", diagnostics) ? "blocked-by-environment" : workflowStatus(diagnostics) === "failed" || commandStatus(commands) === "failed" ? "failed" : "passed";
-  return { sourceStatus, workspaceStatus, overallStatus };
+  return {
+    sourceStatus,
+    workspaceStatus,
+    overallStatus,
+    summary: {
+      sourceChange: sourceStatus,
+      generatedSync: statusForValidationKind(commands, "sync"),
+      workspaceConfig: statusForScope(commands, diagnostics, scopes, "workspace-config"),
+      environment: statusForScope(commands, diagnostics, scopes, "environment")
+    }
+  };
 };
 var createWorkflowValidationRunReport = async ({
   runId = createWorkflowRunId("validation"),
@@ -5032,221 +5048,6 @@ var createRepairReport = ({
 });
 // pkgs/@akanjs/devkit/workflow/executor.ts
 import { capitalize as capitalize2 } from "akanjs/common";
-var workflowStepKey = (workflow, stepId) => `${workflow}:${stepId}`;
-var primitiveReportToWorkflowStepResult = (report) => ({
-  changedFiles: report.changedFiles,
-  generatedFiles: report.generatedFiles,
-  commands: report.validationCommands,
-  diagnostics: report.diagnostics,
-  recommendations: [],
-  nextActions: report.nextActions
-});
-var workflowStringInput = (value) => typeof value === "string" ? value : null;
-var workflowStringListInput = (value) => Array.isArray(value) ? value.join(",") : null;
-var resolveWorkflowSys = async (workspace, target) => {
-  if (!target)
-    return null;
-  const [apps, libs] = await workspace.getSyss();
-  if (apps.includes(target))
-    return AppExecutor.from(workspace, target);
-  if (libs.includes(target))
-    return LibExecutor.from(workspace, target);
-  return null;
-};
-var targetMissing = (input2 = "app") => ({
-  severity: "error",
-  code: "workflow-target-missing",
-  input: input2,
-  message: "Workflow target app or library was not found."
-});
-var inputMissing = (input2) => ({
-  severity: "error",
-  code: "workflow-input-missing",
-  input: input2,
-  message: `Workflow input "${input2}" is required for apply.`
-});
-var unsupportedInput = (input2, message) => ({
-  severity: "error",
-  code: "workflow-input-unsupported",
-  input: input2,
-  message
-});
-var addFieldUiSurfaceInspection = (plan) => {
-  const app = workflowStringInput(plan.inputs.app);
-  const module = workflowStringInput(plan.inputs.module) ?? "<module>";
-  const field = workflowStringInput(plan.inputs.field) ?? "<field>";
-  const typeName = workflowStringInput(plan.inputs.type);
-  const isNumeric = typeName === "Int" || typeName === "Float" || typeName === "integer" || typeName === "float";
-  const moduleClassName = capitalize2(module);
-  const target = `${app ? `apps/${app}` : "*"}/lib/${module}/${moduleClassName}.Template.tsx`;
-  return {
-    recommendations: [
-      {
-        code: "add-field-ui-surface-review",
-        kind: "manual-action",
-        target,
-        action: isNumeric ? `Review ${moduleClassName} Template/Unit/View/Store surfaces before adding ${field}; confirm the local Field.Text numeric parser/formatter, validation rule, and dictionary label pattern.` : `Add ${field} to ${moduleClassName} UI surfaces only when the local Field.* pattern is clear.`,
-        confidence: "medium",
-        message: isNumeric ? `No UI file was modified automatically because a safe numeric input component pattern is not yet detected for ${module}.${field}.` : `Review Template/Unit/View/Store surfaces for ${module}.${field}; no UI file was modified automatically.`
-      }
-    ],
-    nextActions: [
-      {
-        command: `akan workflow explain ${plan.workflow}`,
-        reason: "Review UI surface guidance before manually editing ambiguous UI files."
-      }
-    ]
-  };
-};
-var createWorkflowStepRegistry = ({
-  workspace,
-  createModule,
-  createScalar,
-  createUi,
-  addField,
-  addEnumField
-}) => {
-  const inspect = async () => {
-    return;
-  };
-  const commandOnly = async () => {
-    return;
-  };
-  return {
-    inspectSystem: inspect,
-    inspectModule: inspect,
-    syncTarget: commandOnly,
-    lintTarget: commandOnly,
-    [workflowStepKey("create-module", "create-module")]: async (_step, plan) => {
-      const app = workflowStringInput(plan.inputs.app);
-      const module = workflowStringInput(plan.inputs.module);
-      const sys2 = await resolveWorkflowSys(workspace, app);
-      if (!sys2 || !module)
-        return { diagnostics: [!sys2 ? targetMissing() : inputMissing("module")] };
-      return primitiveReportToWorkflowStepResult(await createModule(sys2, module));
-    },
-    [workflowStepKey("create-scalar", "create-scalar")]: async (_step, plan) => {
-      const app = workflowStringInput(plan.inputs.app);
-      const scalar = workflowStringInput(plan.inputs.scalar);
-      const sys2 = await resolveWorkflowSys(workspace, app);
-      if (!sys2 || !scalar)
-        return { diagnostics: [!sys2 ? targetMissing() : inputMissing("scalar")] };
-      return primitiveReportToWorkflowStepResult(await createScalar(sys2, scalar));
-    },
-    [workflowStepKey("create-ui", "create-ui")]: async (_step, plan) => {
-      const surface = workflowStringInput(plan.inputs.surface);
-      if (surface !== "view" && surface !== "unit" && surface !== "template") {
-        return {
-          diagnostics: [
-            unsupportedInput("surface", "Workflow apply currently supports create-ui surfaces: view, unit, template.")
-          ]
-        };
-      }
-      return primitiveReportToWorkflowStepResult(await createUi({
-        app: workflowStringInput(plan.inputs.app),
-        module: workflowStringInput(plan.inputs.module),
-        surface
-      }));
-    },
-    [workflowStepKey("add-field", "update-constant")]: async (_step, plan) => {
-      if (workflowStringInput(plan.inputs.type)?.toLowerCase() === "enum") {
-        return primitiveReportToWorkflowStepResult(await addEnumField({
-          app: workflowStringInput(plan.inputs.app),
-          module: workflowStringInput(plan.inputs.module),
-          field: workflowStringInput(plan.inputs.field),
-          values: workflowStringListInput(plan.inputs.values),
-          defaultValue: workflowStringInput(plan.inputs.default)
-        }));
-      }
-      return primitiveReportToWorkflowStepResult(await addField({
-        app: workflowStringInput(plan.inputs.app),
-        module: workflowStringInput(plan.inputs.module),
-        field: workflowStringInput(plan.inputs.field),
-        type: workflowStringInput(plan.inputs.type),
-        defaultValue: workflowStringInput(plan.inputs.default)
-      }));
-    },
-    [workflowStepKey("add-field", "update-dictionary")]: inspect,
-    [workflowStepKey("add-field", "update-ui-surfaces")]: async (_step, plan) => addFieldUiSurfaceInspection(plan),
-    [workflowStepKey("add-enum-field", "update-constant")]: async (_step, plan) => primitiveReportToWorkflowStepResult(await addEnumField({
-      app: workflowStringInput(plan.inputs.app),
-      module: workflowStringInput(plan.inputs.module),
-      field: workflowStringInput(plan.inputs.field),
-      values: workflowStringListInput(plan.inputs.values),
-      defaultValue: workflowStringInput(plan.inputs.default)
-    })),
-    [workflowStepKey("add-enum-field", "update-dictionary")]: inspect,
-    [workflowStepKey("add-enum-field", "update-option")]: inspect
-  };
-};
-class WorkflowExecutor {
-  registry;
-  constructor(registry) {
-    this.registry = registry;
-  }
-  async apply(plan) {
-    const changedFiles = [];
-    const generatedFiles = [];
-    const recommendedValidationCommands = [];
-    const diagnostics = [...plan.diagnostics];
-    const recommendations = [...plan.recommendations];
-    const nextActions = [];
-    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
-      return createWorkflowApplyReport({
-        workflow: plan.workflow,
-        mode: "apply",
-        changedFiles,
-        generatedFiles,
-        recommendedValidationCommands,
-        diagnostics,
-        recommendations,
-        nextActions,
-        plan
-      });
-    }
-    recommendedValidationCommands.push(...workflowCommandsForPlan(plan));
-    nextActions.push(...workflowCommandsForPlan(plan));
-    for (const step of plan.steps) {
-      const runner = this.registry[workflowStepKey(plan.workflow, step.id)] ?? this.registry[step.tool] ?? this.registry[step.id];
-      if (!runner) {
-        diagnostics.push({
-          severity: "error",
-          code: "workflow-step-unsupported",
-          message: `Workflow ${plan.workflow} step "${step.id}" is not supported by workflow apply yet.`
-        });
-        nextActions.push({
-          command: `akan workflow explain ${plan.workflow}`,
-          reason: "Review the unsupported workflow step before retrying apply."
-        });
-        break;
-      }
-      const result = await runner(step, plan);
-      if (!result)
-        continue;
-      changedFiles.push(...result.changedFiles ?? []);
-      generatedFiles.push(...result.generatedFiles ?? []);
-      recommendedValidationCommands.push(...result.commands ?? []);
-      diagnostics.push(...result.diagnostics ?? []);
-      recommendations.push(...result.recommendations ?? []);
-      nextActions.push(...result.nextActions ?? []);
-      if (diagnostics.some((diagnostic) => diagnostic.severity === "error"))
-        break;
-    }
-    return createWorkflowApplyReport({
-      workflow: plan.workflow,
-      mode: "apply",
-      changedFiles,
-      generatedFiles,
-      recommendedValidationCommands,
-      diagnostics,
-      recommendations,
-      nextActions,
-      plan
-    });
-  }
-}
-// pkgs/@akanjs/devkit/workflow/plan.ts
-import { capitalize as capitalize3 } from "akanjs/common";
 
 // pkgs/@akanjs/devkit/workflow/primitive.ts
 var createPrimitiveWriteReport = ({
@@ -5298,6 +5099,23 @@ var sourceFile = (sys2, path10, action, reason) => ({
   action,
   reason
 });
+var moduleComponentName = (moduleName) => `${moduleName.slice(0, 1).toUpperCase()}${moduleName.slice(1)}`;
+var moduleSourcePaths = (moduleName) => {
+  const componentName = moduleComponentName(moduleName);
+  return {
+    abstract: `lib/${moduleName}/${moduleName}.abstract.md`,
+    constant: `lib/${moduleName}/${moduleName}.constant.ts`,
+    dictionary: `lib/${moduleName}/${moduleName}.dictionary.ts`,
+    service: `lib/${moduleName}/${moduleName}.service.ts`,
+    signal: `lib/${moduleName}/${moduleName}.signal.ts`,
+    store: `lib/${moduleName}/${moduleName}.store.ts`,
+    template: `lib/${moduleName}/${componentName}.Template.tsx`,
+    unit: `lib/${moduleName}/${componentName}.Unit.tsx`,
+    util: `lib/${moduleName}/${componentName}.Util.tsx`,
+    view: `lib/${moduleName}/${componentName}.View.tsx`,
+    zone: `lib/${moduleName}/${componentName}.Zone.tsx`
+  };
+};
 var generatedFilesForSync = (sys2, reason = "Generated files may change after sync.") => generatedFilePathsForTarget(getSysRoot(sys2), reason);
 var validationCommandsForTarget = (target) => [
   { command: `akan sync ${target}`, reason: "Refresh generated Akan files from source conventions." },
@@ -5324,6 +5142,50 @@ var createPassedPrimitiveReport = ({
 var scalarChangedFiles = (sys2, scalarName, files) => Object.values(files).map((file) => sourceFile(sys2, `lib/__scalar/${scalarName}/${file.filename}`, "create", "Scalar source file was created."));
 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 koLabels = {
+  amount: "\uAE08\uC561",
+  budget: "\uC608\uC0B0",
+  category: "\uCE74\uD14C\uACE0\uB9AC",
+  content: "\uB0B4\uC6A9",
+  count: "\uAC1C\uC218",
+  createdAt: "\uC0DD\uC131\uC77C",
+  date: "\uB0A0\uC9DC",
+  description: "\uC124\uBA85",
+  due: "\uB9C8\uAC10\uC77C",
+  dueAt: "\uB9C8\uAC10\uC77C",
+  email: "\uC774\uBA54\uC77C",
+  enabled: "\uD65C\uC131\uD654",
+  endAt: "\uC885\uB8CC\uC77C",
+  id: "ID",
+  name: "\uC774\uB984",
+  owner: "\uB2F4\uB2F9\uC790",
+  priority: "\uC6B0\uC120\uC21C\uC704",
+  project: "\uD504\uB85C\uC81D\uD2B8",
+  rating: "\uD3C9\uC810",
+  startAt: "\uC2DC\uC791\uC77C",
+  status: "\uC0C1\uD0DC",
+  title: "\uC81C\uBAA9",
+  updatedAt: "\uC218\uC815\uC77C"
+};
+var splitFieldWords = (fieldName) => fieldName.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").split(/\s+/).map((word) => word.trim()).filter(Boolean);
+var koLabelForField = (fieldName) => {
+  if (koLabels[fieldName])
+    return koLabels[fieldName];
+  const words = splitFieldWords(fieldName);
+  const translated = words.map((word) => koLabels[word] ?? koLabels[lowerlize(word)] ?? null);
+  return translated.every(Boolean) ? translated.join(" ") : null;
+};
+var bilingualLabelForField = (fieldName) => {
+  const en = titleize(fieldName);
+  return { en, ko: koLabelForField(fieldName) ?? en };
+};
+var bilingualDescriptionForField = (fieldName) => {
+  const label = bilingualLabelForField(fieldName);
+  return {
+    en: `Enter ${label.en.toLowerCase()}.`,
+    ko: `${label.ko} \uAC12\uC744 \uC785\uB825\uD569\uB2C8\uB2E4.`
+  };
+};
 var normalizeFieldType = (typeName) => {
   const normalizedTypes = {
     string: "String",
@@ -5351,6 +5213,15 @@ var ensureBaseTypeImport = (content, typeName) => {
 ${content}`;
 };
 var numericDefault = (typeName, rawDefault) => {
+  if (typeof rawDefault === "number") {
+    if (!Number.isFinite(rawDefault))
+      return null;
+    if (typeName === "Int" && !Number.isInteger(rawDefault))
+      return null;
+    return String(rawDefault);
+  }
+  if (typeof rawDefault !== "string")
+    return null;
   const trimmed = rawDefault.trim();
   if (!trimmed || !Number.isFinite(Number(trimmed)))
     return null;
@@ -5358,16 +5229,41 @@ var numericDefault = (typeName, rawDefault) => {
     return null;
   return trimmed;
 };
-var coerceFieldDefault = (typeName, defaultValue) => {
-  if (defaultValue === undefined || defaultValue === null || defaultValue === "")
-    return { expression: null };
-  const normalizedType = normalizeFieldType(typeName);
+var booleanDefault = (rawDefault) => {
+  if (typeof rawDefault === "boolean")
+    return String(rawDefault);
+  if (typeof rawDefault !== "string")
+    return null;
+  const lowered = rawDefault.trim().toLowerCase();
+  return lowered === "true" || lowered === "false" ? lowered : null;
+};
+var dateDefault = (rawDefault) => {
+  if (typeof rawDefault === "number" && Number.isFinite(rawDefault))
+    return `new Date(${rawDefault})`;
+  if (typeof rawDefault !== "string")
+    return null;
+  const trimmed = rawDefault.trim();
+  if (!trimmed)
+    return null;
+  if (trimmed === "now")
+    return "new Date()";
+  if (!Number.isNaN(Date.parse(trimmed)))
+    return `new Date(${JSON.stringify(trimmed)})`;
+  return null;
+};
+var coerceFieldDefault = (typeName, defaultValue, options = {}) => {
+  const normalizedType = typeName.toLowerCase() === "enum" ? "enum" : normalizeFieldType(typeName);
+  if (defaultValue === undefined || defaultValue === null || defaultValue === "") {
+    return { expression: null, normalized: false, normalizedType };
+  }
   if (normalizedType === "Int" || normalizedType === "Float") {
     const expression = numericDefault(normalizedType, defaultValue);
     if (expression !== null)
-      return { expression };
+      return { expression, normalized: typeof defaultValue === "string", normalizedType };
     return {
       expression: null,
+      normalized: false,
+      normalizedType,
       diagnostic: {
         severity: "error",
         code: "primitive-default-value-invalid",
@@ -5378,11 +5274,13 @@ var coerceFieldDefault = (typeName, defaultValue) => {
     };
   }
   if (normalizedType === "Boolean") {
-    const lowered = defaultValue.trim().toLowerCase();
-    if (lowered === "true" || lowered === "false")
-      return { expression: lowered };
+    const expression = booleanDefault(defaultValue);
+    if (expression !== null)
+      return { expression, normalized: typeof defaultValue === "string", normalizedType };
     return {
       expression: null,
+      normalized: false,
+      normalizedType,
       diagnostic: {
         severity: "error",
         code: "primitive-default-value-invalid",
@@ -5392,31 +5290,113 @@ var coerceFieldDefault = (typeName, defaultValue) => {
       }
     };
   }
-  return { expression: JSON.stringify(defaultValue) };
-};
-var fieldExpression = (typeName, defaultValue) => {
-  const typeExpression = normalizeFieldType(typeName);
-  const defaultExpression = coerceFieldDefault(typeExpression, defaultValue).expression;
-  const defaultOption = defaultExpression ? `, { default: ${defaultExpression} }` : "";
-  return `field(${typeExpression}${defaultOption})`;
-};
-var insertIntoObject = (content, className, line) => {
-  const classIndex = content.indexOf(`export class ${className} extends via`);
-  if (classIndex < 0)
-    return null;
-  const objectEndIndex = content.indexOf("}))", classIndex);
-  if (objectEndIndex < 0)
-    return null;
-  const prefix = content.slice(0, objectEndIndex);
-  const suffix = content.slice(objectEndIndex);
-  const insertion = prefix.endsWith(`
-`) ? `  ${line}
-` : `
-  ${line}
-`;
-  return `${prefix}${insertion}${suffix}`;
-};
-var ensureEnumImport = (content) => {
+  if (normalizedType === "Date") {
+    const expression = dateDefault(defaultValue);
+    if (expression !== null)
+      return { expression, normalized: true, normalizedType };
+    return {
+      expression: null,
+      normalized: false,
+      normalizedType,
+      diagnostic: {
+        severity: "error",
+        code: "primitive-default-value-invalid",
+        input: "default",
+        failureScope: "source-change",
+        message: `Default value for Date must be "now", a timestamp, or a parseable date string. Received: ${JSON.stringify(defaultValue)}.`
+      }
+    };
+  }
+  if (normalizedType === "enum") {
+    if (typeof defaultValue === "string" && options.enumValues?.includes(defaultValue)) {
+      return { expression: JSON.stringify(defaultValue), normalized: false, normalizedType };
+    }
+    return {
+      expression: null,
+      normalized: false,
+      normalizedType,
+      diagnostic: {
+        severity: "error",
+        code: "primitive-default-value-invalid",
+        input: "default",
+        failureScope: "source-change",
+        message: `Default value for enum must be one of: ${(options.enumValues ?? []).join(", ")}. Received: ${JSON.stringify(defaultValue)}.`
+      }
+    };
+  }
+  return {
+    expression: JSON.stringify(String(defaultValue)),
+    normalized: typeof defaultValue !== "string",
+    normalizedType
+  };
+};
+var fieldExpression = (typeName, defaultValue, options = {}) => {
+  const typeExpression = normalizeFieldType(typeName);
+  const defaultExpression = coerceFieldDefault(options.enumValues ? "enum" : typeExpression, defaultValue, options).expression;
+  const defaultOption = defaultExpression ? `, { default: ${defaultExpression} }` : "";
+  return `field(${typeExpression}${defaultOption})`;
+};
+var insertIntoObject = (content, className, line) => {
+  const classIndex = content.indexOf(`export class ${className} extends via`);
+  if (classIndex < 0)
+    return null;
+  const objectEndIndex = content.indexOf("}))", classIndex);
+  if (objectEndIndex < 0)
+    return null;
+  const prefix = content.slice(0, objectEndIndex);
+  const suffix = content.slice(objectEndIndex);
+  const insertion = prefix.endsWith(`
+`) ? `  ${line}
+` : `
+  ${line}
+`;
+  return `${prefix}${insertion}${suffix}`;
+};
+var insertLightProjectionField = (content, moduleClassName, fieldName) => {
+  const classIndex = content.indexOf(`export class Light${moduleClassName} extends via`);
+  if (classIndex < 0)
+    return null;
+  const arrayMatch = /\[([\s\S]*?)\]\s+as const/.exec(content.slice(classIndex));
+  if (!arrayMatch || arrayMatch.index === undefined)
+    return null;
+  const arrayStart = classIndex + arrayMatch.index;
+  const arrayEnd = arrayStart + arrayMatch[0].length;
+  const fields = [...arrayMatch[1].matchAll(/"([^"]+)"/g)].map((match) => match[1]).filter(Boolean);
+  if (fields.includes(fieldName))
+    return content;
+  const nextFields = [...fields, fieldName];
+  const nextArray = nextFields.length === 0 ? "[] as const" : `[
+${nextFields.map((field) => `  ${JSON.stringify(field)},`).join(`
+`)}
+] as const`;
+  return `${content.slice(0, arrayStart)}${nextArray}${content.slice(arrayEnd)}`;
+};
+var insertTemplateField = ({
+  content,
+  moduleName,
+  moduleClassName,
+  fieldName,
+  component
+}) => {
+  if (content.includes(`l("${moduleName}.${fieldName}")`) || content.includes(`.${fieldName}`))
+    return content;
+  const layoutEndIndex = content.indexOf("    </Layout.Template>");
+  if (layoutEndIndex < 0)
+    return null;
+  const formName = `${moduleName}Form`;
+  if (!content.includes(`const ${formName} = st.use.${moduleName}Form();`))
+    return null;
+  const fieldSetter = `st.do.set${moduleComponentName(fieldName)}On${moduleClassName}`;
+  const fieldBlock = `      <${component}
+        label={l("${moduleName}.${fieldName}")}
+        desc={l("${moduleName}.${fieldName}.desc")}
+        value={${formName}.${fieldName}}
+        onChange={${fieldSetter}}
+      />
+`;
+  return `${content.slice(0, layoutEndIndex)}${fieldBlock}${content.slice(layoutEndIndex)}`;
+};
+var ensureEnumImport = (content) => {
   if (content.includes("enumOf"))
     return content;
   const baseImport = /import \{ ([^}]+) \} from "akanjs\/base";/.exec(content);
@@ -5445,14 +5425,15 @@ ${enumClass}`;
 var insertDictionaryModelField = (content, moduleClassName, fieldName) => {
   if (new RegExp(`\\b${fieldName}\\s*:`).test(content))
     return content;
-  const label = titleize(fieldName);
+  const label = bilingualLabelForField(fieldName);
+  const desc = bilingualDescriptionForField(fieldName);
   const modelIndex = content.indexOf(`.model<${moduleClassName}>((t) => ({`);
   if (modelIndex < 0)
     return null;
   const objectEndIndex = content.indexOf("  }))", modelIndex);
   if (objectEndIndex < 0)
     return null;
-  return `${content.slice(0, objectEndIndex)}    ${fieldName}: t([${JSON.stringify(label)}, ${JSON.stringify(label)}]).desc([${JSON.stringify(label)}, ${JSON.stringify(label)}]),
+  return `${content.slice(0, objectEndIndex)}    ${fieldName}: t([${JSON.stringify(label.en)}, ${JSON.stringify(label.ko)}]).desc([${JSON.stringify(desc.en)}, ${JSON.stringify(desc.ko)}]),
 ${content.slice(objectEndIndex)}`;
 };
 var ensureConstantTypeImport = (content, constantPath, typeName) => {
@@ -5483,7 +5464,273 @@ ${values.map((value) => `    ${value}: t([${JSON.stringify(titleize(value))}, ${
 };
 var parseValues = (value) => value?.split(",").map((item) => item.trim()).filter(Boolean) ?? [];
 
+// pkgs/@akanjs/devkit/workflow/uiPolicy.ts
+var addFieldUiPolicyForType = (typeName) => {
+  const normalizedType = typeName.toLowerCase() === "enum" ? "enum" : normalizeFieldType(typeName);
+  if (normalizedType === "Int" || normalizedType === "Float") {
+    return {
+      normalizedType,
+      component: "Field.Number",
+      confidence: "high",
+      autoTemplateSupported: true
+    };
+  }
+  if (normalizedType === "Date") {
+    return {
+      normalizedType,
+      component: "Field.Date",
+      confidence: "high",
+      autoTemplateSupported: true
+    };
+  }
+  if (normalizedType === "Boolean" || normalizedType === "enum") {
+    return {
+      normalizedType,
+      component: "Field.ToggleSelect",
+      confidence: "medium",
+      autoTemplateSupported: false
+    };
+  }
+  if (normalizedType === "String") {
+    return {
+      normalizedType,
+      component: "Field.Text",
+      confidence: "high",
+      autoTemplateSupported: true
+    };
+  }
+  return {
+    normalizedType,
+    component: "Field.Text",
+    confidence: "low",
+    autoTemplateSupported: false
+  };
+};
+
+// pkgs/@akanjs/devkit/workflow/executor.ts
+var workflowStepKey = (workflow, stepId) => `${workflow}:${stepId}`;
+var primitiveReportToWorkflowStepResult = (report) => ({
+  changedFiles: report.changedFiles,
+  generatedFiles: report.generatedFiles,
+  commands: report.validationCommands,
+  diagnostics: report.diagnostics,
+  recommendations: [],
+  nextActions: report.nextActions
+});
+var workflowStringInput = (value) => typeof value === "string" ? value : null;
+var workflowStringListInput = (value) => Array.isArray(value) ? value.join(",") : null;
+var workflowStringArrayInput = (value) => Array.isArray(value) ? value : null;
+var workflowBooleanInput = (value) => typeof value === "boolean" ? value : null;
+var resolveWorkflowSys = async (workspace, target) => {
+  if (!target)
+    return null;
+  const [apps, libs] = await workspace.getSyss();
+  if (apps.includes(target))
+    return AppExecutor.from(workspace, target);
+  if (libs.includes(target))
+    return LibExecutor.from(workspace, target);
+  return null;
+};
+var targetMissing = (input2 = "app") => ({
+  severity: "error",
+  code: "workflow-target-missing",
+  input: input2,
+  message: "Workflow target app or library was not found."
+});
+var inputMissing = (input2) => ({
+  severity: "error",
+  code: "workflow-input-missing",
+  input: input2,
+  message: `Workflow input "${input2}" is required for apply.`
+});
+var unsupportedInput = (input2, message) => ({
+  severity: "error",
+  code: "workflow-input-unsupported",
+  input: input2,
+  message
+});
+var addFieldUiSurfaceInspection = (plan) => {
+  const app = workflowStringInput(plan.inputs.app);
+  const module = workflowStringInput(plan.inputs.module) ?? "<module>";
+  const field = workflowStringInput(plan.inputs.field) ?? "<field>";
+  const typeName = workflowStringInput(plan.inputs.type);
+  const policy = addFieldUiPolicyForType(typeName ?? "String");
+  const surfaces = workflowStringArrayInput(plan.inputs.surfaces);
+  const templateRequested = surfaces?.includes("template") ?? false;
+  const moduleClassName = capitalize2(module);
+  const target = `${app ? `apps/${app}` : "*"}/${moduleSourcePaths(module).template}`;
+  return {
+    recommendations: [
+      {
+        code: "add-field-ui-surface-review",
+        kind: "manual-action",
+        target,
+        action: templateRequested ? `Template was requested for ${field}. If no Template file changed, auto-edit was skipped because the file was missing, the generated ${module}Form/Layout.Template pattern was not found, or ${policy.component} needs option binding. Candidate position: inside Layout.Template near the existing Field components.` : `Template was not selected, so UI files are intentionally left unchanged. Candidate positions if you expose it later: Layout.Template field list for editing, Light${moduleClassName} projection for list/card data, and Unit/View card sections for display.`,
+        confidence: "medium",
+        message: `Review UI surfaces for ${module}.${field}; recommended component is ${policy.component}, with manual reasons and candidate positions in action.`
+      }
+    ],
+    nextActions: [
+      {
+        command: `akan workflow explain ${plan.workflow}`,
+        reason: "Review UI surface guidance before manually editing ambiguous UI files."
+      }
+    ]
+  };
+};
+var createWorkflowStepRegistry = ({
+  workspace,
+  createModule,
+  createScalar,
+  createUi,
+  addField,
+  addEnumField
+}) => {
+  const inspect = async () => {
+    return;
+  };
+  const commandOnly = async () => {
+    return;
+  };
+  return {
+    inspectSystem: inspect,
+    inspectModule: inspect,
+    syncTarget: commandOnly,
+    lintTarget: commandOnly,
+    [workflowStepKey("create-module", "create-module")]: async (_step, plan) => {
+      const app = workflowStringInput(plan.inputs.app);
+      const module = workflowStringInput(plan.inputs.module);
+      const sys2 = await resolveWorkflowSys(workspace, app);
+      if (!sys2 || !module)
+        return { diagnostics: [!sys2 ? targetMissing() : inputMissing("module")] };
+      return primitiveReportToWorkflowStepResult(await createModule(sys2, module));
+    },
+    [workflowStepKey("create-scalar", "create-scalar")]: async (_step, plan) => {
+      const app = workflowStringInput(plan.inputs.app);
+      const scalar = workflowStringInput(plan.inputs.scalar);
+      const sys2 = await resolveWorkflowSys(workspace, app);
+      if (!sys2 || !scalar)
+        return { diagnostics: [!sys2 ? targetMissing() : inputMissing("scalar")] };
+      return primitiveReportToWorkflowStepResult(await createScalar(sys2, scalar));
+    },
+    [workflowStepKey("create-ui", "create-ui")]: async (_step, plan) => {
+      const surface = workflowStringInput(plan.inputs.surface);
+      if (surface !== "view" && surface !== "unit" && surface !== "template") {
+        return {
+          diagnostics: [
+            unsupportedInput("surface", "Workflow apply currently supports create-ui surfaces: view, unit, template.")
+          ]
+        };
+      }
+      return primitiveReportToWorkflowStepResult(await createUi({
+        app: workflowStringInput(plan.inputs.app),
+        module: workflowStringInput(plan.inputs.module),
+        surface
+      }));
+    },
+    [workflowStepKey("add-field", "update-constant")]: async (_step, plan) => {
+      if (workflowStringInput(plan.inputs.type)?.toLowerCase() === "enum") {
+        return primitiveReportToWorkflowStepResult(await addEnumField({
+          app: workflowStringInput(plan.inputs.app),
+          module: workflowStringInput(plan.inputs.module),
+          field: workflowStringInput(plan.inputs.field),
+          values: workflowStringListInput(plan.inputs.values),
+          defaultValue: workflowStringInput(plan.inputs.default),
+          surfaces: workflowStringArrayInput(plan.inputs.surfaces),
+          includeInLight: workflowBooleanInput(plan.inputs.includeInLight)
+        }));
+      }
+      return primitiveReportToWorkflowStepResult(await addField({
+        app: workflowStringInput(plan.inputs.app),
+        module: workflowStringInput(plan.inputs.module),
+        field: workflowStringInput(plan.inputs.field),
+        type: workflowStringInput(plan.inputs.type),
+        defaultValue: workflowStringInput(plan.inputs.default),
+        surfaces: workflowStringArrayInput(plan.inputs.surfaces),
+        includeInLight: workflowBooleanInput(plan.inputs.includeInLight)
+      }));
+    },
+    [workflowStepKey("add-field", "update-dictionary")]: inspect,
+    [workflowStepKey("add-field", "update-ui-surfaces")]: async (_step, plan) => addFieldUiSurfaceInspection(plan),
+    [workflowStepKey("add-enum-field", "update-constant")]: async (_step, plan) => primitiveReportToWorkflowStepResult(await addEnumField({
+      app: workflowStringInput(plan.inputs.app),
+      module: workflowStringInput(plan.inputs.module),
+      field: workflowStringInput(plan.inputs.field),
+      values: workflowStringListInput(plan.inputs.values),
+      defaultValue: workflowStringInput(plan.inputs.default)
+    })),
+    [workflowStepKey("add-enum-field", "update-dictionary")]: inspect,
+    [workflowStepKey("add-enum-field", "update-option")]: inspect
+  };
+};
+class WorkflowExecutor {
+  registry;
+  constructor(registry) {
+    this.registry = registry;
+  }
+  async apply(plan) {
+    const changedFiles = [];
+    const generatedFiles = [];
+    const recommendedValidationCommands = [];
+    const diagnostics = [...plan.diagnostics];
+    const recommendations = [...plan.recommendations];
+    const nextActions = [];
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+      return createWorkflowApplyReport({
+        workflow: plan.workflow,
+        mode: "apply",
+        changedFiles,
+        generatedFiles,
+        recommendedValidationCommands,
+        diagnostics,
+        recommendations,
+        nextActions,
+        plan
+      });
+    }
+    recommendedValidationCommands.push(...workflowCommandsForPlan(plan));
+    nextActions.push(...workflowCommandsForPlan(plan));
+    for (const step of plan.steps) {
+      const runner = this.registry[workflowStepKey(plan.workflow, step.id)] ?? this.registry[step.tool] ?? this.registry[step.id];
+      if (!runner) {
+        diagnostics.push({
+          severity: "error",
+          code: "workflow-step-unsupported",
+          message: `Workflow ${plan.workflow} step "${step.id}" is not supported by workflow apply yet.`
+        });
+        nextActions.push({
+          command: `akan workflow explain ${plan.workflow}`,
+          reason: "Review the unsupported workflow step before retrying apply."
+        });
+        break;
+      }
+      const result = await runner(step, plan);
+      if (!result)
+        continue;
+      changedFiles.push(...result.changedFiles ?? []);
+      generatedFiles.push(...result.generatedFiles ?? []);
+      recommendedValidationCommands.push(...result.commands ?? []);
+      diagnostics.push(...result.diagnostics ?? []);
+      recommendations.push(...result.recommendations ?? []);
+      nextActions.push(...result.nextActions ?? []);
+      if (diagnostics.some((diagnostic) => diagnostic.severity === "error"))
+        break;
+    }
+    return createWorkflowApplyReport({
+      workflow: plan.workflow,
+      mode: "apply",
+      changedFiles,
+      generatedFiles,
+      recommendedValidationCommands,
+      diagnostics,
+      recommendations,
+      nextActions,
+      plan
+    });
+  }
+}
 // pkgs/@akanjs/devkit/workflow/plan.ts
+import { capitalize as capitalize3 } from "akanjs/common";
 var surfaceModes = new Set(["infer", "include", "skip"]);
 var parseStringList = (value) => {
   if (Array.isArray(value)) {
@@ -5501,6 +5748,18 @@ var normalizeInputValue = (name, spec, value) => {
     const values = parseStringList(value);
     return values && values.length > 0 ? values : null;
   }
+  if (spec.type === "boolean") {
+    if (typeof value === "boolean")
+      return value;
+    if (typeof value !== "string")
+      return null;
+    const lowered = value.trim().toLowerCase();
+    if (lowered === "true")
+      return true;
+    if (lowered === "false")
+      return false;
+    return null;
+  }
   if (typeof value === "string" && surfaceModes.has(value))
     return value;
   throw new Error(`Unsupported workflow input value for ${name}`);
@@ -5508,17 +5767,45 @@ var normalizeInputValue = (name, spec, value) => {
 var listWorkflowSpecs = (specs) => [...specs].sort((a, b) => a.name.localeCompare(b.name));
 var getWorkflowSpec = (specs, name) => specs.find((spec) => spec.name === name) ?? null;
 var compactWorkflowInputs = (inputs) => Object.fromEntries(Object.entries(inputs).filter(([, value]) => value !== null && value !== ""));
-var addFieldComponentForType = (typeName) => {
-  const normalizedType = normalizeFieldType(typeName);
-  if (normalizedType === "Boolean")
-    return "Field.ToggleSelect";
-  if (normalizedType === "Date")
-    return "Field.Date";
-  if (normalizedType === "Int" || normalizedType === "Float")
-    return "manual numeric input review";
-  if (typeName.toLowerCase() === "enum")
-    return "Field.ToggleSelect";
-  return "Field.Text";
+var addFieldTargetRoot = (app) => app ? `apps/${app}` : "*";
+var addFieldPaths = (inputs) => {
+  const app = typeof inputs.app === "string" ? inputs.app : null;
+  const module = typeof inputs.module === "string" ? inputs.module : "<module>";
+  const paths = moduleSourcePaths(module);
+  const root = addFieldTargetRoot(app);
+  return {
+    constant: `${root}/${paths.constant}`,
+    dictionary: `${root}/${paths.dictionary}`,
+    template: `${root}/${paths.template}`,
+    unit: `${root}/${paths.unit}`,
+    view: `${root}/${paths.view}`
+  };
+};
+var selectedAddFieldSurfaces = (inputs) => Array.isArray(inputs.surfaces) ? new Set(inputs.surfaces) : null;
+var addFieldDefaultCoercion = (inputs) => {
+  const typeName = typeof inputs.type === "string" ? inputs.type : null;
+  const defaultValue = typeof inputs.default === "string" ? inputs.default : null;
+  if (!typeName || defaultValue === null)
+    return null;
+  if (typeName.toLowerCase() === "number" || typeName.toLowerCase() === "numeric")
+    return null;
+  const enumValues = Array.isArray(inputs.values) ? inputs.values : null;
+  return coerceFieldDefault(typeName.toLowerCase() === "enum" ? "enum" : typeName, defaultValue, { enumValues });
+};
+var createAddFieldDefaultRecommendations = (inputs) => {
+  const field = typeof inputs.field === "string" ? inputs.field : "<field>";
+  const coercion = addFieldDefaultCoercion(inputs);
+  if (!coercion?.normalized || !coercion.expression)
+    return [];
+  return [
+    {
+      code: "add-field-default-normalized",
+      kind: "manual-action",
+      confidence: "high",
+      message: `Default for ${field} will be normalized to ${coercion.normalizedType} literal ${coercion.expression}.`,
+      action: "Review the normalized default in the apply report if this value should stay unset."
+    }
+  ];
 };
 var createAddFieldRecommendations = (inputs) => {
   const app = typeof inputs.app === "string" ? inputs.app : "<app-or-lib>";
@@ -5527,16 +5814,18 @@ var createAddFieldRecommendations = (inputs) => {
   const typeName = typeof inputs.type === "string" ? inputs.type : null;
   if (!typeName)
     return [];
-  const normalizedType = typeName.toLowerCase() === "enum" ? "enum" : normalizeFieldType(typeName);
-  const constantPath = `*/lib/${module}/${module}.constant.ts`;
-  const dictionaryPath = `*/lib/${module}/${module}.dictionary.ts`;
-  const templatePath = `*/lib/${module}/${capitalize3(module)}.Template.tsx`;
+  const policy = addFieldUiPolicyForType(typeName);
+  const normalizedType = policy.normalizedType;
+  const paths = addFieldPaths(inputs);
+  const surfaces = selectedAddFieldSurfaces(inputs);
+  const templateRequested = surfaces?.has("template") ?? false;
+  const includeInLight = inputs.includeInLight === true;
   return [
     ...normalizedType === "Int" || normalizedType === "Float" ? [
       {
         code: "add-field-import",
         kind: "import",
-        target: constantPath,
+        target: paths.constant,
         confidence: "high",
         message: `Import ${normalizedType} from "akanjs/base" before writing field(${normalizedType}).`
       }
@@ -5544,35 +5833,122 @@ var createAddFieldRecommendations = (inputs) => {
     {
       code: "add-field-placement-constant",
       kind: "placement",
-      target: constantPath,
+      target: paths.constant,
       confidence: "high",
       message: `Insert ${field}: field(${normalizedType}) in ${capitalize3(module)}Input.`
     },
     {
       code: "add-field-placement-dictionary",
       kind: "placement",
-      target: dictionaryPath,
+      target: paths.dictionary,
       confidence: "high",
       message: `Add dictionary labels for ${module}.${field}.`
     },
     {
       code: "add-field-component",
       kind: "ui-component",
-      target: templatePath,
-      confidence: normalizedType === "Int" || normalizedType === "Float" ? "low" : "high",
-      action: normalizedType === "Int" || normalizedType === "Float" ? "Do not auto-edit UI. Check local Template/Unit/View patterns for Field.Text parsing, formatting, validation rules, and dictionary labels before adding a numeric input." : undefined,
-      message: normalizedType === "Int" || normalizedType === "Float" ? `Numeric UI for ${field} (${normalizedType}) requires manual review; a safe numeric input component pattern is not yet detected.` : `Recommended UI component for ${field} (${normalizedType}): ${addFieldComponentForType(typeName)}.`
+      target: paths.template,
+      confidence: policy.confidence,
+      action: templateRequested ? `apply_workflow will try to add ${policy.component} to Template when the existing Template has a safe generated field-list pattern.` : `Recommended component is ${policy.component}. Pass surfaces=["template"] when this field should be rendered in the Template form.`,
+      message: `Recommended UI component for ${field} (${normalizedType}): ${policy.component}.`
     },
+    ...!surfaces ? [
+      {
+        code: "add-field-template-surface-choice",
+        kind: "manual-action",
+        target: paths.template,
+        action: `Choose whether to expose ${field} in Template by passing surfaces=["template"].`,
+        confidence: "medium",
+        message: `Template exposure for ${module}.${field} is not selected yet.`
+      }
+    ] : [],
+    ...!includeInLight ? [
+      {
+        code: "add-field-light-projection-choice",
+        kind: "manual-action",
+        target: paths.constant,
+        action: `Pass includeInLight=true when ${field} should appear in Light${capitalize3(module)} list/card projections.`,
+        confidence: "medium",
+        message: `Light projection exposure for ${module}.${field} is not selected yet.`
+      }
+    ] : [],
+    ...includeInLight ? [
+      {
+        code: "add-field-light-projection",
+        kind: "placement",
+        target: paths.constant,
+        confidence: "high",
+        message: `Add ${field} to Light${capitalize3(module)} projection fields.`
+      }
+    ] : [],
+    ...surfaces && !templateRequested ? [
+      {
+        code: "add-field-ui-surface-skip",
+        kind: "manual-action",
+        target: paths.template,
+        confidence: "medium",
+        message: `Template is not included in surfaces, so ${module}.${field} will not be auto-rendered there.`
+      }
+    ] : [],
     {
       code: "add-field-ui-manual-review",
       kind: "manual-action",
-      target: templatePath,
-      action: `Review ${app}:${module} Template/Unit/View/Store surfaces and add ${field} only where the existing pattern is clear. For numeric fields, confirm parser/formatter behavior and validation before using Field.Text.`,
+      target: paths.template,
+      action: `Review ${app}:${module} UI after apply. Template auto-edit requires a generated ${module}Form hook and Layout.Template field list; Unit/View are not auto-edited because list/card placement depends on local layout. Candidate positions: Layout.Template before the closing tag, Light${capitalize3(module)} projection array for list data, and Unit/View card sections for display.`,
       confidence: "medium",
-      message: normalizedType === "Int" || normalizedType === "Float" ? "UI surface edits stay manual because a safe numeric input component pattern is not yet detected." : "UI surface edits are planned as manual-review unless a safe existing field-list pattern is detected."
+      message: "UI manual review includes the reason auto-edit may be skipped and candidate insertion positions."
+    },
+    ...createAddFieldDefaultRecommendations(inputs)
+  ];
+};
+var createWorkflowPlanPredictedChanges = (spec, inputs) => {
+  if (spec.name !== "add-field")
+    return spec.predictedChanges;
+  const paths = addFieldPaths(inputs);
+  const surfaces = selectedAddFieldSurfaces(inputs);
+  const includeInLight = inputs.includeInLight === true;
+  return [
+    {
+      target: paths.constant,
+      action: "modify",
+      applyScope: "auto",
+      reason: includeInLight ? "Field shape and Light projection are added." : "Field shape is added."
+    },
+    {
+      target: paths.dictionary,
+      action: "modify",
+      applyScope: "auto",
+      reason: "Field label is added."
+    },
+    ...!surfaces || surfaces.has("template") ? [
+      {
+        target: paths.template,
+        action: "modify",
+        applyScope: surfaces?.has("template") ? "auto" : "manual-review",
+        reason: surfaces?.has("template") ? "Template form is selected for safe-pattern auto insertion." : "Form surface may include the field."
+      }
+    ] : [],
+    {
+      target: `${addFieldTargetRoot(typeof inputs.app === "string" ? inputs.app : null)}/lib/cnst.ts`,
+      action: "sync",
+      applyScope: "generated-sync",
+      reason: "Generated constants may change after sync."
+    },
+    {
+      target: `${addFieldTargetRoot(typeof inputs.app === "string" ? inputs.app : null)}/lib/dict.ts`,
+      action: "sync",
+      applyScope: "generated-sync",
+      reason: "Generated dictionary barrel may change after sync."
     }
   ];
 };
+var createWorkflowPlanOptionalSurfaces = (spec, inputs) => {
+  const optionalSurfaces = spec.optionalSurfaces ?? {};
+  const surfaces = selectedAddFieldSurfaces(inputs);
+  if (spec.name !== "add-field" || !surfaces)
+    return optionalSurfaces;
+  return Object.fromEntries(Object.entries(optionalSurfaces).map(([surface, mode]) => [surface, surfaces.has(surface) ? "include" : mode]));
+};
 var createWorkflowPlanRecommendations = (spec, inputs) => [
   {
     code: "workflow-apply-first",
@@ -5636,14 +6012,32 @@ var createWorkflowPlan = (spec, rawInputs) => {
       message: `Field type "${fieldType}" is ambiguous in Akan. Use Int for integer fields or Float for decimal fields.`
     });
   }
+  if (spec.name === "add-field") {
+    const defaultCoercion = addFieldDefaultCoercion(inputs);
+    if (defaultCoercion?.diagnostic) {
+      diagnostics.push({
+        ...defaultCoercion.diagnostic,
+        code: "workflow-default-value-invalid",
+        message: `Plan input default is not valid for ${defaultCoercion.normalizedType}: ${defaultCoercion.diagnostic.message}`
+      });
+    } else if (defaultCoercion?.normalized && defaultCoercion.expression) {
+      diagnostics.push({
+        severity: "warning",
+        code: "workflow-default-value-normalized",
+        input: "default",
+        failureScope: "source-change",
+        message: `Plan input default will be written as ${defaultCoercion.normalizedType} literal ${defaultCoercion.expression}.`
+      });
+    }
+  }
   return {
     schemaVersion: 1,
     workflow: spec.name,
     mode: "plan",
     inputs,
-    optionalSurfaces: spec.optionalSurfaces ?? {},
+    optionalSurfaces: createWorkflowPlanOptionalSurfaces(spec, inputs),
     steps: spec.steps,
-    predictedChanges: spec.predictedChanges,
+    predictedChanges: createWorkflowPlanPredictedChanges(spec, inputs),
     validation: spec.validation,
     diagnostics,
     recommendations: createWorkflowPlanRecommendations(spec, inputs),
@@ -5712,35 +6106,55 @@ var renderWorkflowPlan = (plan) => [
   ""
 ].join(`
 `);
-var renderWorkflowApplyReport = (report) => [
-  `# Workflow Apply: ${report.workflow}`,
-  "",
-  `- Mode: ${report.mode}`,
-  `- Status: ${report.status}`,
-  "",
-  "## Changed Files",
-  ...report.changedFiles.length ? report.changedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
-  "",
-  "## Generated Files",
-  ...report.generatedFiles.length ? report.generatedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
-  "",
-  "## Applied Commands",
-  ...report.appliedCommands.length ? report.appliedCommands.map((command) => `- \`${command.command}\`: ${command.reason}`) : ["- none"],
-  "",
-  "## Recommended Validation Commands",
-  ...report.recommendedValidationCommands.length ? report.recommendedValidationCommands.map((command) => `- \`${command.command}\`: ${command.reason}`) : ["- none"],
-  "",
-  "## Diagnostics",
-  ...report.diagnostics.length ? report.diagnostics.map((diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`) : ["- none"],
-  "",
-  "## Recommendations",
-  ...report.recommendations.length ? report.recommendations.map((recommendation) => `- [${recommendation.kind}] ${recommendation.message}`) : ["- none"],
-  "",
-  "## Next Actions",
-  ...report.nextActions.length ? report.nextActions.map((action) => `- \`${action.command}\`: ${action.reason}`) : ["- none"],
-  ""
-].join(`
+var renderRecommendation = (recommendation) => {
+  const target = recommendation.target ? ` ${recommendation.target}` : "";
+  const action = recommendation.action ? ` Action: ${recommendation.action}` : "";
+  return `- [${recommendation.kind}]${target} ${recommendation.message}${action}`;
+};
+var renderDiagnostic = (diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`;
+var renderWorkflowApplyReport = (report) => {
+  const manualReviewItems = [
+    ...report.diagnostics.filter((diagnostic) => diagnostic.severity === "warning").map(renderDiagnostic),
+    ...report.recommendations.filter((recommendation) => recommendation.kind === "manual-action").map(renderRecommendation)
+  ];
+  const validationBlockers = report.diagnostics.filter((diagnostic) => diagnostic.severity === "error" && (diagnostic.failureScope === "workspace-config" || diagnostic.failureScope === "environment")).map(renderDiagnostic);
+  return [
+    `# Workflow Apply: ${report.workflow}`,
+    "",
+    `- Mode: ${report.mode}`,
+    `- Status: ${report.status}`,
+    ...report.validationTarget ? [`- Validation target: ${report.validationTarget}`] : [],
+    "",
+    "## Automatically Modified",
+    ...report.changedFiles.length ? report.changedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
+    "",
+    "## Generated Sync",
+    ...report.generatedFiles.length ? report.generatedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
+    "",
+    "## Applied Commands",
+    ...report.appliedCommands.length ? report.appliedCommands.map((command) => `- \`${command.command}\`: ${command.reason}`) : ["- none"],
+    "",
+    "## Recommended Validation Commands",
+    ...report.recommendedValidationCommands.length ? report.recommendedValidationCommands.map((command) => `- \`${command.command}\`: ${command.reason}`) : ["- none"],
+    "",
+    "## User Review Required",
+    ...manualReviewItems.length ? manualReviewItems : ["- none"],
+    "",
+    "## Validation Blockers",
+    ...validationBlockers.length ? validationBlockers : report.recommendedValidationCommands.length ? ["- none detected during apply; run validation with the validation target for command-level blockers."] : ["- none"],
+    "",
+    "## Diagnostics",
+    ...report.diagnostics.length ? report.diagnostics.map(renderDiagnostic) : ["- none"],
+    "",
+    "## Recommendations",
+    ...report.recommendations.length ? report.recommendations.map(renderRecommendation) : ["- none"],
+    "",
+    "## Next Actions",
+    ...report.nextActions.length ? report.nextActions.map((action) => `- \`${action.command}\`: ${action.reason}`) : ["- none"],
+    ""
+  ].join(`
 `);
+};
 var renderWorkflowApply = (report, format = "markdown") => format === "json" ? jsonText(report) : renderWorkflowApplyReport(report);
 var renderWorkflowValidationRunReport = (report) => [
   `# Workflow Validation: ${report.workflow}`,
@@ -5751,11 +6165,18 @@ var renderWorkflowValidationRunReport = (report) => [
   `- Workspace status: ${report.workspaceStatus}`,
   `- Overall status: ${report.overallStatus}`,
   "",
+  "## Status Summary",
+  `- Required source-change validation: ${report.summary.sourceChange}`,
+  `- Generated sync validation: ${report.summary.generatedSync}`,
+  `- Workspace configuration validation: ${report.summary.workspaceConfig}`,
+  `- Environment validation: ${report.summary.environment}`,
+  "",
   "## Known Blockers",
   ...report.knownBlockers.length ? report.knownBlockers.map((blocker) => {
     const command = blocker.command ? ` \`${blocker.command}\`` : "";
     const count = blocker.count > 1 ? ` (${blocker.count}x)` : "";
-    return `- [${blocker.failureScope}]${command}${count}: ${blocker.message}`;
+    const known = blocker.known ? " known" : "";
+    return `- [${blocker.failureScope}${known}]${command}${count}: ${blocker.message}`;
   }) : ["- none"],
   "",
   "## Commands",
@@ -12663,6 +13084,8 @@ var NODE_NATIVE_MODULE_SET = new Set([
 ]);
 // pkgs/@akanjs/devkit/getCredentials.ts
 import yaml from "js-yaml";
+// pkgs/@akanjs/devkit/getModelFileData.ts
+import { capitalize as capitalize8 } from "akanjs/common";
 // pkgs/@akanjs/devkit/getRelatedCnsts.ts
 import { readFileSync as readFileSync4, realpathSync } from "fs";
 import ora2 from "ora";