@akanjs/cli 3.0.0-beta.17 → 3.0.0-beta.19

package/{index-qhtj9y6j.js → index-2446k7b4.js}

@@ -2,7 +2,7 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-crmeqnmf.js";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `
@@ -416,6 +416,7 @@ var renderPrimitiveWriteReport = (report) => [
 `);
 var renderPrimitiveReport = (report, format = "markdown") => format === "json" ? jsonText(report) : renderPrimitiveWriteReport(report);
 // pkgs/@akanjs/devkit/workflow/executor.ts
+import { capitalize } from "akanjs/common";
 import ts3 from "typescript";
 
 // pkgs/@akanjs/devkit/workflow/moduleIndex.ts
@@ -531,20 +532,24 @@ var normalizeFieldType = (typeName) => {
   };
   return normalizedTypes[typeName.toLowerCase()] ?? typeName;
 };
-var ensureBaseTypeImport = (content, typeName) => {
-  if (typeName !== "Int" && typeName !== "Float")
-    return content;
-  const source = sourceFileFor("constant.ts", content);
-  const baseImport = findNamedImport(source, "akanjs/base");
-  if (baseImport) {
-    if (baseImport.names.includes(typeName))
+var ensureNamedImport = (content, moduleSpecifier, name) => {
+  const source = sourceFileFor("source.ts", content);
+  const namedImport = findNamedImport(source, moduleSpecifier);
+  if (namedImport) {
+    if (namedImport.names.includes(name))
       return content;
-    const nextNames = [...baseImport.names, typeName].sort();
-    return spliceText(content, baseImport.namedBindingsStart, baseImport.namedBindingsEnd, `{ ${nextNames.join(", ")} }`);
+    const nextNames = [...namedImport.names, name].sort();
+    return spliceText(content, namedImport.namedBindingsStart, namedImport.namedBindingsEnd, `{ ${nextNames.join(", ")} }`);
   }
-  return `import { ${typeName} } from "akanjs/base";
+  return `import { ${name} } from "${moduleSpecifier}";
 ${content}`;
 };
+var ensureBaseImport = (content, name) => ensureNamedImport(content, "akanjs/base", name);
+var ensureBaseTypeImport = (content, typeName) => {
+  if (typeName !== "Int" && typeName !== "Float")
+    return content;
+  return ensureBaseImport(content, typeName);
+};
 var numericDefault = (typeName, rawDefault) => {
   if (typeof rawDefault === "number") {
     if (!Number.isFinite(rawDefault))
@@ -572,16 +577,16 @@ var booleanDefault = (rawDefault) => {
 };
 var dateDefault = (rawDefault) => {
   if (typeof rawDefault === "number" && Number.isFinite(rawDefault))
-    return `new Date(${rawDefault})`;
+    return `() => dayjs(${rawDefault})`;
   if (typeof rawDefault !== "string")
     return null;
   const trimmed = rawDefault.trim();
   if (!trimmed)
     return null;
   if (trimmed === "now")
-    return "new Date()";
+    return "() => dayjs()";
   if (!Number.isNaN(Date.parse(trimmed)))
-    return `new Date(${JSON.stringify(trimmed)})`;
+    return `() => dayjs(${JSON.stringify(trimmed)})`;
   return null;
 };
 var coerceFieldDefault = (typeName, defaultValue, options = {}) => {
@@ -1941,6 +1946,52 @@ var addFieldUiSurfaceInspection = (plan) => {
     ]
   };
 };
+var addMutationActionSurfaceInspection = (plan) => {
+  const module = workflowStringInput(plan.inputs.module) ?? "<module>";
+  const mutation = workflowStringInput(plan.inputs.mutation) ?? "<mutation>";
+  const moduleClassName = moduleComponentName(module);
+  return {
+    recommendations: [
+      {
+        code: "add-mutation-action-surface-review",
+        kind: "manual-action",
+        target: `*/${moduleSourcePaths(module).store}`,
+        action: `Name the endpoint's guards and add its dictionary .endpoint() entry with a .desc(). After sync, fetch.${mutation} exists; write a store action only for a toast, an optimistic update, or a multi-field write, and put the control that calls it in ${moduleClassName}.Util.tsx.`,
+        confidence: "medium",
+        message: `Workflow apply does not write store or UI code for ${module}.${mutation}; review whether a screen should call it.`
+      }
+    ],
+    nextActions: [
+      {
+        command: `akan workflow explain ${plan.workflow}`,
+        reason: "Review action surface guidance before manually editing store or UI files."
+      }
+    ]
+  };
+};
+var addSliceViewSurfaceInspection = (plan) => {
+  const module = workflowStringInput(plan.inputs.module) ?? "<module>";
+  const slice = workflowStringInput(plan.inputs.slice) ?? "<slice>";
+  const moduleClassName = moduleComponentName(module);
+  return {
+    recommendations: [
+      {
+        code: "add-slice-view-surface-review",
+        kind: "manual-action",
+        target: `*/${moduleSourcePaths(module).zone}`,
+        action: `Fill in the service query stub and add the dictionary .slice() entry. After sync, load fetch.init${moduleClassName}${capitalize(slice)}() in the page and pass the result to a ${moduleClassName}.Zone as an init prop.`,
+        confidence: "medium",
+        message: `Workflow apply does not write page or Zone code for ${module}.${slice}; review where the list should render.`
+      }
+    ],
+    nextActions: [
+      {
+        command: `akan workflow explain ${plan.workflow}`,
+        reason: "Review view surface guidance before manually editing Zone or page files."
+      }
+    ]
+  };
+};
 var createWorkflowStepRegistry = ({
   workspace,
   createModule,
@@ -2032,12 +2083,14 @@ var createWorkflowStepRegistry = ({
       mutation: workflowStringInput(plan.inputs.mutation)
     })),
     [workflowStepKey("add-mutation", "update-signal")]: inspect,
+    [workflowStepKey("add-mutation", "update-action-surfaces")]: async (_step, plan) => addMutationActionSurfaceInspection(plan),
     [workflowStepKey("add-slice", "update-service-query")]: async (_step, plan) => primitiveReportToWorkflowStepResult(await addSlice({
       app: workflowStringInput(plan.inputs.app),
       module: workflowStringInput(plan.inputs.module),
       slice: workflowStringInput(plan.inputs.slice)
     })),
-    [workflowStepKey("add-slice", "update-signal-slice")]: inspect
+    [workflowStepKey("add-slice", "update-signal-slice")]: inspect,
+    [workflowStepKey("add-slice", "connect-view-surfaces")]: async (_step, plan) => addSliceViewSurfaceInspection(plan)
   };
 };
 class WorkflowExecutor {
@@ -2126,7 +2179,7 @@ class WorkflowExecutor {
   }
 }
 // pkgs/@akanjs/devkit/workflow/plan.ts
-import { capitalize } from "akanjs/common";
+import { capitalize as capitalize2 } from "akanjs/common";
 var surfaceModes = new Set(["infer", "include", "skip"]);
 var parseStringList = (value) => {
   if (Array.isArray(value)) {
@@ -2269,7 +2322,7 @@ var createAddFieldRecommendations = (inputs) => {
       kind: "placement",
       target: paths.constant,
       confidence: "high",
-      message: `Insert ${field}: field(${normalizedType}) in ${capitalize(module)}Input.`
+      message: `Insert ${field}: field(${normalizedType}) in ${capitalize2(module)}Input.`
     },
     {
       code: "add-field-placement-dictionary",
@@ -2301,7 +2354,7 @@ var createAddFieldRecommendations = (inputs) => {
         code: "add-field-light-projection-choice",
         kind: "manual-action",
         target: paths.constant,
-        action: `Pass includeInLight=true when users should see ${field} in list/card data. Without it, the field can exist on ${capitalize(module)}Input but stay absent from Light${capitalize(module)} projections.`,
+        action: `Pass includeInLight=true when users should see ${field} in list/card data. Without it, the field can exist on ${capitalize2(module)}Input but stay absent from Light${capitalize2(module)} projections.`,
         confidence: "medium",
         message: `${module}.${field} is not selected for list/card projection data.`
       }
@@ -2312,7 +2365,7 @@ var createAddFieldRecommendations = (inputs) => {
         kind: "placement",
         target: paths.constant,
         confidence: "high",
-        message: `Add ${field} to Light${capitalize(module)} projection fields.`
+        message: `Add ${field} to Light${capitalize2(module)} projection fields.`
       }
     ] : [],
     ...surfaces && !templateRequested ? [
@@ -2329,7 +2382,7 @@ var createAddFieldRecommendations = (inputs) => {
       code: "add-field-ui-manual-review",
       kind: "manual-action",
       target: paths.template,
-      action: `After apply, verify what users can see: Template form auto-edit only runs when a generated ${module}Form hook and Layout.Template field list are present. Unit/View cards are not auto-edited, so ${field} may be stored on ${capitalize(module)} but not shown in list/card UI until you place it in the local card layout.`,
+      action: `After apply, verify what users can see: Template form auto-edit only runs when a generated ${module}Form hook and Layout.Template field list are present. Unit/View cards are not auto-edited, so ${field} may be stored on ${capitalize2(module)} but not shown in list/card UI until you place it in the local card layout.`,
       confidence: "medium",
       message: `${app}:${module}.${field} may need UI review for user-visible Template, Unit, and View behavior.`
     },
@@ -2774,4 +2827,4 @@ for (const candidate of toolingRolloutCandidates) {
   if (isRestrictedCandidate(candidate))
     restrictedCandidates.set(candidate.packageName, candidate);
 }
-export { jsonText, compactDiagnostics, workflowPlanApproval, createWorkflowApplyReport, workflowCommandsForPlan, workflowRunArtifactPath, writeWorkflowRunArtifact, workflowSyncDir, generatedFilePathsForTarget, writeGeneratedSyncState, readWorkflowRunArtifact, createWorkflowBaselineSummary, createWorkflowValidationRunReport, createDryRunWorkflowApplyReport, createRepairReport, createPrimitiveWriteReport, renderPrimitiveReport, sourceFile, moduleComponentName, moduleSourcePaths, generatedFilesForSync, validationCommandsForTarget, nextActionsForTarget, createPassedPrimitiveReport, scalarChangedFiles, lowerlize, bilingualLabelForField, bilingualDescriptionForField, normalizeFieldType, ensureBaseTypeImport, coerceFieldDefault, fieldExpression, viaBuilderParameterName, insertIntoObject, insertLightProjectionField, insertTemplateField, ensureEnumImport, insertEnumClass, insertDictionaryModelField, hasConstantInputField, hasDictionaryModelField, ensureConstantTypeImport, insertDictionaryEnum, parseValues, hasSourceParseErrors, hasClassMethod, insertClassMethod, hasSignalFactoryEntry, insertSignalFactoryEntry, buildAkanModuleContextIndex, addFieldUiPolicyForType, createWorkflowStepRegistry, WorkflowExecutor, listWorkflowSpecs, getWorkflowSpec, compactWorkflowInputs, createWorkflowPlan, renderWorkflowList, renderWorkflowExplain, renderWorkflowPlan, renderWorkflowApply, renderWorkflowValidation, renderRepairReport, renderWorkflowRunArtifact, toolingRolloutGate };
+export { jsonText, compactDiagnostics, workflowPlanApproval, createWorkflowApplyReport, workflowCommandsForPlan, workflowRunArtifactPath, writeWorkflowRunArtifact, workflowSyncDir, generatedFilePathsForTarget, writeGeneratedSyncState, readWorkflowRunArtifact, createWorkflowBaselineSummary, createWorkflowValidationRunReport, createDryRunWorkflowApplyReport, createRepairReport, createPrimitiveWriteReport, renderPrimitiveReport, sourceFile, moduleComponentName, moduleSourcePaths, generatedFilesForSync, validationCommandsForTarget, nextActionsForTarget, createPassedPrimitiveReport, scalarChangedFiles, lowerlize, bilingualLabelForField, bilingualDescriptionForField, normalizeFieldType, ensureNamedImport, ensureBaseImport, ensureBaseTypeImport, coerceFieldDefault, fieldExpression, viaBuilderParameterName, insertIntoObject, insertLightProjectionField, insertTemplateField, ensureEnumImport, insertEnumClass, insertDictionaryModelField, hasConstantInputField, hasDictionaryModelField, ensureConstantTypeImport, insertDictionaryEnum, parseValues, hasSourceParseErrors, hasClassMethod, insertClassMethod, hasSignalFactoryEntry, insertSignalFactoryEntry, buildAkanModuleContextIndex, addFieldUiPolicyForType, createWorkflowStepRegistry, WorkflowExecutor, listWorkflowSpecs, getWorkflowSpec, compactWorkflowInputs, createWorkflowPlan, renderWorkflowList, renderWorkflowExplain, renderWorkflowPlan, renderWorkflowApply, renderWorkflowValidation, renderRepairReport, renderWorkflowRunArtifact, toolingRolloutGate };

package/{index-g9zghs4h.js → index-3jrp517k.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   AppExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-crmeqnmf.js";
 import {
   jsonText,
   createWorkflowBaselineSummary,
   buildAkanModuleContextIndex,
   createWorkflowStepRegistry,
   toolingRolloutGate
-} from "./index-qhtj9y6j.js";
+} from "./index-2446k7b4.js";
 import {
   buildResourceList,
   codexMcpConfigPath,
@@ -18,32 +18,32 @@ import {
   upsertCodexMcpServerBlock,
   renderDoctorText,
   AkanContextAnalyzer
-} from "./index-v17gj504.js";
+} from "./index-18zybgkc.js";
 import {
   isPlaceholderAppId2
-} from "./index-3cymrzsb.js";
+} from "./index-vqx8bdxz.js";
 import {
   CommandContainer,
   runner
-} from "./index-6na0sd2b.js";
+} from "./index-qdgzsnhg.js";
 import {
   Prompter2
-} from "./index-twq9p2sp.js";
+} from "./index-s5rhm04y.js";
 import {
   RepairRunner
-} from "./index-4cvpzkq6.js";
+} from "./index-53176s7j.js";
 import {
   WorkflowRunner
-} from "./index-2pm1j01n.js";
+} from "./index-txr7dj2g.js";
 import {
   ModuleScript
-} from "./index-xjc7gg65.js";
+} from "./index-esk82rvk.js";
 import {
   PrimitiveScript
-} from "./index-te0y1c0m.js";
+} from "./index-zqgj2rt2.js";
 import {
   ScalarScript
-} from "./index-vpx68e4x.js";
+} from "./index-4m929vvn.js";
 import {
   getMobileTargets
 } from "./index-47pj3aee.js";
@@ -1021,7 +1021,7 @@ ${payload}`);
       test: "`akan test <app-or-lib-or-pkg>` prepares the target and runs its tests.",
       build: "`akan build <app-name>` creates a production build after preparing generated files.",
       doctor: "`akan doctor --strict --format json` reports agent-readable workspace convention diagnostics and validation hints.",
-      "guideline show": "`akan guideline show <name>` prints an Akan codegen guideline instruction.",
+      "guideline show": "`akan guideline show <name>` prints an Akan guideline instruction.",
       workflow: "`akan workflow list|explain|plan|apply|validate|report` lists, plans, applies, validates, and reports agent-readable Akan workflows.",
       "workflow list": "`akan workflow list` lists parseable read-only workflow specs.",
       "workflow explain": "`akan workflow explain <workflow>` explains inputs, optional surfaces, steps, and validation.",

package/{index-vpx68e4x.js → index-4m929vvn.js}

@@ -2,12 +2,12 @@
 import {
   runner,
   script
-} from "./index-6na0sd2b.js";
+} from "./index-qdgzsnhg.js";
 import {
   generatedFilesForSync,
   createPassedPrimitiveReport,
   scalarChangedFiles
-} from "./index-qhtj9y6j.js";
+} from "./index-2446k7b4.js";
 import {
   pluralizeName
 } from "./index-nz8prx9g.js";

package/{index-4cvpzkq6.js → index-53176s7j.js}

@@ -5,13 +5,13 @@ import {
   writeGeneratedSyncState,
   createRepairReport,
   renderRepairReport
-} from "./index-qhtj9y6j.js";
+} from "./index-2446k7b4.js";
 import {
   AkanContextAnalyzer
-} from "./index-v17gj504.js";
+} from "./index-18zybgkc.js";
 import {
   runner
-} from "./index-6na0sd2b.js";
+} from "./index-qdgzsnhg.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/{index-jwrpsrg3.js → index-667w0yah.js}

@@ -1,6 +1,6 @@
 // @bun
 // pkgs/@akanjs/devkit/codeAgent/agent/akanCodeModel.ts
-var akanCodeDefaultModel2 = { provider: "deepseek", id: "deepseek-v4-flash" };
+var akanCodeDefaultModel2 = { provider: "deepseek", id: "deepseek-flash" };
 var catalogueMissesImages = new Set(["deepseek/deepseek-v4-flash"]);
 var correctInputs = (model) => {
   if (!model || model.input.includes("image"))

package/{index-3mg4h788.js → index-7ep8qtvp.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-6na0sd2b.js";
+} from "./index-qdgzsnhg.js";
 import {
   LibExecutor
-} from "./index-p4p9t45x.js";
+} from "./index-crmeqnmf.js";
 import {
   LibSource,
   formatLibStatuses

package/{index-w8kmx1b6.js → index-89hy31kf.js}

@@ -1147,6 +1147,7 @@ var SSR_CLIENT_ALIAS_EXTERNALS = [
 class RouteClientBuilder {
   #app;
   #seeds;
+  #graphSeeds;
   #knownEntries;
   #command;
   #discovery;
@@ -1154,20 +1155,22 @@ class RouteClientBuilder {
   constructor(options) {
     this.#app = options.app;
     this.#seeds = options.seeds;
+    this.#graphSeeds = options.graphSeeds;
     this.#knownEntries = options.knownEntries ?? new Set;
     this.#command = options.command ?? "start";
     this.#discovery = options.discovery;
     this.#entries = options.entries;
   }
   async build() {
-    const discovered = this.#entries ?? await (this.#discovery ?? await GraphClientEntryDiscovery.create(this.#app)).discover(this.#seeds);
-    const entries = discovered.filter((e) => !this.#knownEntries.has(e));
-    if (entries.length === 0)
+    const discovered = this.#entries ?? await (await this.#getDiscovery()).discover(this.#seeds);
+    if (discovered.every((e) => this.#knownEntries.has(e)))
       return this.#emptyResult(discovered);
+    const entries = this.#graphSeeds ? [...new Set([...discovered, ...await (await this.#getDiscovery()).discover(this.#graphSeeds)])].sort() : discovered.filter((e) => !this.#knownEntries.has(e));
     const bootstrapEntries = await this.#createBootstrapEntries(entries);
     const browserBundle = await this.#buildBrowserBundle(bootstrapEntries);
     const ssrBundle = await this.#buildSsrBundle(bootstrapEntries);
     const acceptedEntries = new Set(entries);
+    const routeEntries = new Set(discovered);
     const manifestDelta = {};
     const ssrModuleMap = {};
     const clientDeps = new Set;
@@ -1195,18 +1198,23 @@ class RouteClientBuilder {
         deps.add(path6.resolve(dep));
       const sortedDeps = [...deps].sort();
       clientDepsByEntry[originalEntry] = sortedDeps;
-      for (const dep of sortedDeps)
-        clientDeps.add(dep);
+      if (routeEntries.has(originalEntry))
+        for (const dep of sortedDeps)
+          clientDeps.add(dep);
     }
     return {
       manifestDelta,
       ssrManifestDelta: { moduleLoading: null, moduleMap: ssrModuleMap },
-      newEntries: entries,
+      newEntries: entries.filter((e) => !this.#knownEntries.has(e)),
       discoveredEntries: discovered,
       clientDeps: [...clientDeps].sort(),
       clientDepsByEntry
     };
   }
+  async#getDiscovery() {
+    this.#discovery ??= await GraphClientEntryDiscovery.create(this.#app);
+    return this.#discovery;
+  }
   #emptyResult(discoveredEntries = []) {
     return {
       manifestDelta: {},
@@ -1440,6 +1448,7 @@ var LIB_BARRELS = {
   cnst: { barrel: "cnst", kind: "namespace" },
   srv: { barrel: "srv", kind: "namespace" }
 };
+var GLOBAL_NAMES = new Set(["fetch"]);
 var DOMAIN_DENYLIST = new Set([
   "Map",
   "Set",
@@ -1642,10 +1651,11 @@ var transformSource = (source, fileName, ctx, resolveExtra) => {
   const sf = ts2.createSourceFile(fileName, source, ts2.ScriptTarget.Latest, true, scriptKindFor(fileName));
   const bound = collectBoundNames(sf);
   const used = collectUsedReferences(sf);
+  const bareGlobals = collectBareGlobalReferences(sf);
   const namedBySpecifier = new Map;
   const namespaceImports = [];
   for (const name of used) {
-    if (bound.has(name))
+    if (bound.has(name) || bareGlobals.has(name))
       continue;
     const target = targetFor(name, ctx) ?? resolveExtra?.(name) ?? null;
     if (!target)
@@ -1743,6 +1753,19 @@ var collectUsedReferences = (sf) => {
   ts2.forEachChild(sf, visit);
   return used;
 };
+var collectBareGlobalReferences = (sf) => {
+  const bare = new Set;
+  const visit = (node) => {
+    if (ts2.isIdentifier(node) && GLOBAL_NAMES.has(node.text) && isReferencePosition(node)) {
+      const parent = node.parent;
+      if (!(parent && ts2.isPropertyAccessExpression(parent) && parent.expression === node))
+        bare.add(node.text);
+    }
+    ts2.forEachChild(node, visit);
+  };
+  ts2.forEachChild(sf, visit);
+  return bare;
+};
 var isReferencePosition = (node) => {
   const parent = node.parent;
   if (!parent)