@akanjs/cli 3.0.0-alpha.1 → 3.0.0-alpha.10

package/incrementalBuilder.proc.js

@@ -8,7 +8,7 @@ import {
   DevGeneratedIndexSync,
   GraphClientEntryDiscovery,
   RouteClientBuilder
-} from "./index-rh16j3c7.js";
+} from "./index-j9cxndc0.js";
 import {
   HmrWatcher,
   WatchRootResolver
@@ -16,8 +16,9 @@ import {
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/index-1577bej2.js

@@ -0,0 +1,7 @@
+// @bun
+// pkgs/@akanjs/devkit/getDirname.ts
+import path from "path";
+import { fileURLToPath } from "url";
+var getDirname = (url) => path.dirname(fileURLToPath(url));
+
+export { getDirname };

package/{index-bekddz9q.js → index-3vta1tqa.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-yzmhasdb.js";
+} from "./index-jhpa13zj.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-rzwcpcc3.js";
+} from "./index-rxkpk7n4.js";
 import {
   script
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-zasydjxd.js → index-4m0bphac.js}

@@ -7,14 +7,14 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   openBrowser
-} from "./index-e16gnn26.js";
+} from "./index-62955kn5.js";
 import {
   runner
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
 import path from "path";

package/{index-1pvex4az.js → index-5sn5w2mt.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   RepairRunner
-} from "./index-mr5s7mqd.js";
+} from "./index-jf2ya7r2.js";
 import {
   WorkflowRunner
-} from "./index-2q1f5j9k.js";
+} from "./index-qzdjd4ct.js";
+import {
+  ScalarScript
+} from "./index-y4vkyhvv.js";
 import {
   PrimitiveScript
-} from "./index-bekddz9q.js";
+} from "./index-3vta1tqa.js";
 import {
   ModuleScript
-} from "./index-yzmhasdb.js";
-import {
-  ScalarScript
-} from "./index-ec09pws3.js";
+} from "./index-jhpa13zj.js";
 import {
   isPlaceholderAppId
-} from "./index-t3723f99.js";
+} from "./index-779ske1y.js";
 import {
   AkanContextAnalyzer,
   akanMcpInstallConfigPaths,
@@ -27,17 +27,17 @@ import {
   renderDoctorText,
   resourceList,
   upsertCodexMcpServerBlock
-} from "./index-a00jg8x8.js";
+} from "./index-774gcx29.js";
 import {
   buildAkanModuleContextIndex,
   createWorkflowBaselineSummary,
   createWorkflowStepRegistry,
   jsonText,
   toolingRolloutGate
-} from "./index-rzwcpcc3.js";
+} from "./index-rxkpk7n4.js";
 import {
   Prompter
-} from "./index-tdbas9r0.js";
+} from "./index-j37qq1f2.js";
 import {
   getMobileTargets
 } from "./index-76rn3g2c.js";
@@ -45,10 +45,10 @@ import {
   CommandContainer,
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   AppExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-e16gnn26.js → index-62955kn5.js}

@@ -1,14 +1,14 @@
 // @bun
+import {
+  LibraryScript
+} from "./index-d43t8af2.js";
 import {
   resolveMobileTargets
 } from "./index-76rn3g2c.js";
-import {
-  LibraryScript
-} from "./index-7c6k4yvg.js";
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   HmrWatcher,
   WatchRootResolver
@@ -18,7 +18,7 @@ import {
   LibExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 import {
   __require
 } from "./index-r24hmh0q.js";
@@ -1898,9 +1898,9 @@ function openBrowser(url) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-ct2pxyvw.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-ha3y8ew8.js")).ApplicationBuildRunner;
 var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-4r9sm3qg.js")).CapacitorApp;
+var loadCapacitorApp = async () => (await import("./capacitorApp-9xswcgx7.js")).CapacitorApp;
 var loadAbstractCompactor = async () => (await import("./abstractCompactor-e5yq60qz.js")).AbstractCompactor;
 var loadPrompts = async () => await import("@inquirer/prompts");
 

package/{index-a00jg8x8.js → index-774gcx29.js}

@@ -2,11 +2,16 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-rzwcpcc3.js";
+} from "./index-rxkpk7n4.js";
 import {
   AppExecutor,
-  LibExecutor
-} from "./index-hgna5rjy.js";
+  LibExecutor,
+  appRootAllowedDirs,
+  appRootAllowedFiles,
+  extractBlockVersion,
+  isScannedAppRootEntry,
+  readDevkitVersion
+} from "./index-z8ptfkzv.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,
@@ -121,7 +126,9 @@ var validationCommands = [
   "akan typecheck <app-name>",
   "akan test <app-or-lib-or-pkg>",
   "akan build <app-name>",
-  "akan doctor --strict --format json"
+  "akan doctor --strict --format json",
+  "akan quality scan [--format json]",
+  "akan quality ssr [--format json]"
 ];
 var unknownGeneratedFilesFreshness = {
   status: "unknown",
@@ -150,33 +157,6 @@ var moduleShapeFiles = (module) => {
   ];
 };
 var constantFieldNames = (content) => [...content.matchAll(/\b([A-Za-z_$][\w$]*)\s*:\s*field\(/g)].map((match) => match[1]).filter(Boolean);
-var appRootAllowFiles = new Set([
-  "AGENTS.md",
-  "CLAUDE.md",
-  "akan.app.json",
-  "akan.config.ts",
-  "capacitor.config.ts",
-  "client.ts",
-  "main.ts",
-  "package.json",
-  "server.ts",
-  "tsconfig.json"
-]);
-var appRootAllowDirs = new Set([
-  ".akan",
-  "android",
-  "common",
-  "env",
-  "ios",
-  "lib",
-  "page",
-  "private",
-  "public",
-  "script",
-  "srvkit",
-  "ui",
-  "webkit"
-]);
 var safeReadDir = async (dirPath) => {
   try {
     return (await readdir(dirPath, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
@@ -389,6 +369,29 @@ class AkanContextAnalyzer {
       validationCommands
     };
   }
+  static async#agentGuideDrift(workspace) {
+    const installed = await readDevkitVersion();
+    if (!installed)
+      return null;
+    const content = await safeReadText(path.join(workspace.workspaceRoot, "AGENTS.md"));
+    if (content === null)
+      return null;
+    const stamped = extractBlockVersion(content);
+    if (stamped === installed)
+      return null;
+    const hint = "Re-render the AGENTS.md managed block from the installed framework release.";
+    if (!stamped)
+      return {
+        code: "agent-guide-unstamped",
+        message: `AGENTS.md carries no generated-version stamp, so its conventions may predate @akanjs/devkit ${installed}`,
+        hint
+      };
+    return {
+      code: "agent-guide-stale",
+      message: `AGENTS.md was generated by @akanjs/devkit ${stamped}, but ${installed} is installed`,
+      hint
+    };
+  }
   static async doctor(workspace, {
     strict = false,
     runIdOrPlan = null,
@@ -404,7 +407,9 @@ class AkanContextAnalyzer {
     for (const app of context.apps) {
       const appPath = path.join(workspace.workspaceRoot, app.path);
       for (const entry of await safeReadDir(appPath)) {
-        const allowed = entry.isDirectory() ? appRootAllowDirs.has(entry.name) : appRootAllowFiles.has(entry.name);
+        if (!isScannedAppRootEntry(entry.name))
+          continue;
+        const allowed = entry.isDirectory() ? appRootAllowedDirs.has(entry.name) : appRootAllowedFiles.has(entry.name);
         if (!allowed) {
           const action = repairAction("module-shape", `akan repair module-shape --app ${app.name}`, "Review app root shape and remove or move the unknown entry.", false);
           diagnostics.push({
@@ -418,6 +423,18 @@ class AkanContextAnalyzer {
         }
       }
     }
+    const agentDrift = await AkanContextAnalyzer.#agentGuideDrift(workspace);
+    if (agentDrift) {
+      const action = repairAction("generated", "akan agent install agents-md", agentDrift.hint, true);
+      diagnostics.push({
+        severity: "warning",
+        code: agentDrift.code,
+        path: "AGENTS.md",
+        message: agentDrift.message,
+        repairActions: [action]
+      });
+      repairActions.push(action);
+    }
     for (const sys of [...context.apps, ...context.libs]) {
       for (const module of sys.modules) {
         if (!module.abstract.exists) {

package/{index-t3723f99.js → index-779ske1y.js}

@@ -5,7 +5,7 @@ import {
 } from "./index-76rn3g2c.js";
 import {
   CommandExecutionError
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp, mkdir, readFile, rm, writeFile } from "fs/promises";
@@ -514,6 +514,10 @@ function getAdbDeviceStateIssues(output) {
     return [];
   });
 }
+function getAndroidLocalServerHost(adbDevicesOutput, fallbackHost) {
+  const onlineDeviceIds = adbDevicesOutput?.split(/\r?\n/).map((line) => line.trim().split(/\s+/)).filter(([id, state]) => id && state === "device").map(([id]) => id) ?? [];
+  return onlineDeviceIds.length === 1 && onlineDeviceIds[0]?.startsWith("emulator-") ? "10.0.2.2" : fallbackHost;
+}
 var ANDROID_MIN_SDK_VERSION = 26;
 function raiseGradleMinSdkVersion(content, floor = ANDROID_MIN_SDK_VERSION) {
   const match = content.match(/minSdkVersion\s*=\s*(\d+)/);
@@ -691,7 +695,7 @@ class CapacitorApp {
   async save() {
     await this.project.commit();
   }
-  async#prepareIos({ operation, env, regenerate = false }) {
+  async#prepareIos({ operation, env, regenerate = false, iosRunTargetKind }) {
     await this.init({ platform: "ios", operation, env, regenerate });
     await this.#prepareTargetAssets();
     await this.#prepareExternalFiles("ios");
@@ -700,9 +704,10 @@ class CapacitorApp {
     await this.#applyDeepLinks("ios", { operation, env });
     await this.#flushIosEntitlements();
     await this.project.commit();
+    await this.#setCodeSignEntitlementsInIosIfExists("App/App.entitlements");
     await this.#generateAssets({ operation, env });
     this.app.verbose(`syncing iOS`);
-    await this.#spawnMobile("npx", ["cap", "sync", "ios"], { operation, env });
+    await this.#spawnMobile("npx", ["cap", "sync", "ios"], { operation, env }, { iosRunTargetKind });
     this.app.verbose(`sync completed.`);
   }
   async buildIos({ env = "debug", regenerate = false } = {}) {
@@ -721,10 +726,10 @@ class CapacitorApp {
   async runIos({ operation, env, regenerate = false, noAllowProvisioningUpdates = false, iosDeviceId }) {
     if (operation === "release")
       await this.prepareWww();
-    await this.#prepareIos({ operation, env, regenerate });
     const runTarget = await this.#selectIosRunTarget(iosDeviceId);
+    await this.#prepareIos({ operation, env, regenerate, iosRunTargetKind: runTarget.kind });
     if (runTarget.kind === "simulator") {
-      await this.#spawnMobile("npx", ["cap", "run", "ios", "--target", runTarget.id], { operation, env }, { stdio: "inherit" });
+      await this.#spawnMobile("npx", ["cap", "run", "ios", "--target", runTarget.id, "--no-sync"], { operation, env }, { stdio: "inherit", platform: "ios", iosRunTargetKind: runTarget.kind });
       return;
     }
     await this.#runIosPhysicalDevice({ operation, env, runTarget, noAllowProvisioningUpdates });
@@ -800,7 +805,7 @@ ${textError instanceof Error ? textError.message : ""}`);
     noAllowProvisioningUpdates
   }) {
     const mobileEnv = sanitizeIosNativeRunEnv(await this.#commandEnv(operation, env));
-    const configContent = await this.#writeCapacitorConfig({ operation }, mobileEnv);
+    const configContent = await this.#writeCapacitorConfig({ operation, platform: "ios", iosRunTargetKind: runTarget.kind }, mobileEnv);
     await this.#writeRootCapacitorConfig(configContent);
     const scheme = this.#iosScheme();
     const command = buildIosNativeRunCommand({
@@ -857,6 +862,7 @@ ${error.message}`;
     await this.#applyAndroidMinSdkVersion();
     await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("android", { operation, env });
+    await this.#disableNativeKeyboardResizeInAndroid();
     await this.project.commit();
     await this.#generateAssets({ operation, env });
     await this.#ensureAndroidAssetsDir();
@@ -916,6 +922,23 @@ ${error.message}`;
   async openAndroid() {
     await this.#spawnMobile("npx", ["cap", "open", "android"], { operation: "local", env: "local" });
   }
+  async#disableNativeKeyboardResizeInAndroid() {
+    const manifestPath = path.join(this.app.cwdPath, this.androidRootPath, "app/src/main/AndroidManifest.xml");
+    let manifest = await readFile(manifestPath, "utf8");
+    let changed = false;
+    manifest = manifest.replace(/<activity\b[^>]*android:name="\.MainActivity"[^>]*>/, (activityTag) => {
+      if (activityTag.includes("android:windowSoftInputMode=")) {
+        const nextTag = activityTag.replace(/android:windowSoftInputMode="[^"]*"/, 'android:windowSoftInputMode="adjustNothing"');
+        changed ||= nextTag !== activityTag;
+        return nextTag;
+      }
+      changed = true;
+      return activityTag.replace(/>$/, `
+            android:windowSoftInputMode="adjustNothing">`);
+    });
+    if (changed)
+      await writeFile(manifestPath, manifest);
+  }
   async#ensureAndroidAssetsDir() {
     await mkdir(path.join(this.app.cwdPath, this.androidAssetsPath), { recursive: true });
   }
@@ -1005,12 +1028,16 @@ ${error.message}`;
     return html.replace(/<\/head\s*>/i, `${script}
 </head>`);
   }
-  async#writeCapacitorConfig({ operation }, commandEnv) {
+  async#writeCapacitorConfig({
+    operation,
+    platform,
+    iosRunTargetKind
+  }, commandEnv) {
     await mkdir(this.targetRoot, { recursive: true });
     let localIp;
     if (operation === "local") {
       const override = commandEnv.AKAN_PUBLIC_CLIENT_HOST ?? process.env.AKAN_PUBLIC_CLIENT_HOST;
-      const resolution = selectLocalDevHost(os.networkInterfaces(), { override });
+      const resolution = await this.#resolveLocalDevHost({ override, platform, iosRunTargetKind });
       localIp = resolution.host;
       this.#logDevHostResolution(resolution, commandEnv);
     }
@@ -1024,9 +1051,29 @@ ${error.message}`;
     await Bun.write(path.join(this.targetRoot, "capacitor.config.json"), content);
     return content;
   }
+  async#resolveLocalDevHost({
+    override,
+    platform,
+    iosRunTargetKind
+  }) {
+    const resolution = selectLocalDevHost(os.networkInterfaces(), { override });
+    if (resolution.source === "override")
+      return resolution;
+    if (platform === "ios" && iosRunTargetKind === "simulator")
+      return { ...resolution, host: "localhost", source: "platform" };
+    if (platform === "android") {
+      try {
+        const host = getAndroidLocalServerHost(await this.#spawn("adb", ["devices"]), resolution.host);
+        return host === resolution.host ? resolution : { ...resolution, host, source: "platform" };
+      } catch {
+        return resolution;
+      }
+    }
+    return resolution;
+  }
   #logDevHostResolution(resolution, commandEnv) {
     this.app.log(`Mobile live-reload server: ${this.#localCsrUrl(resolution.host, commandEnv)}`);
-    if (resolution.source === "override")
+    if (resolution.source === "override" || resolution.source === "platform")
       return;
     const suspicious = resolution.host === "127.0.0.1" || resolution.host.startsWith("169.254.");
     const alternatives = resolution.candidates.filter((candidate) => candidate.address !== resolution.host);
@@ -1226,18 +1273,26 @@ ${error.message}`;
     return await this.app.spawn(command, args, { cwd: this.app.cwdPath, ...options });
   }
   async#spawnMobile(command, args = [], { operation, env }, options = {}) {
+    const { iosRunTargetKind, platform, ...spawnOptions } = options;
     const mobileEnv = { ...await this.#commandEnv(operation, env), ...options.env };
-    const configContent = await this.#writeCapacitorConfig({ operation }, mobileEnv);
+    const configContent = await this.#writeCapacitorConfig({ operation, platform: platform ?? this.#inferMobilePlatform(args), iosRunTargetKind }, mobileEnv);
     await this.#writeRootCapacitorConfig(configContent);
     try {
       return await this.#spawn(command, args, {
-        ...options,
+        ...spawnOptions,
         env: mobileEnv
       });
     } finally {
       await this.#clearRootCapacitorConfigs();
     }
   }
+  #inferMobilePlatform(args) {
+    if (args.includes("android"))
+      return "android";
+    if (args.includes("ios"))
+      return "ios";
+    return;
+  }
   async addCamera() {
     await this.#setPermissionInIos({
       cameraUsageDescription: "$(PRODUCT_NAME) requires access to the camera to take photos.",
@@ -1339,17 +1394,31 @@ ${error.message}`;
       while (end < lines.length && !/^\s*\};\s*$/.test(lines[end] ?? ""))
         end++;
       const settings = lines.slice(start, end + 1);
-      if (settings.some((setting) => setting.includes("CODE_SIGN_ENTITLEMENTS")))
-        continue;
+      const configName = lines.slice(end + 1, end + 8).find((setting) => setting.includes("name = ")) ?? "";
       const indent = line.match(/^\s*/)?.[0] ?? "";
-      lines.splice(index, 0, `${indent}CODE_SIGN_ENTITLEMENTS = ${entitlementsRelPath};`);
-      index++;
-      changed = true;
+      const insertSettings = [];
+      if (!settings.some((setting) => setting.includes("CODE_SIGN_ENTITLEMENTS"))) {
+        insertSettings.push(`${indent}CODE_SIGN_ENTITLEMENTS = ${entitlementsRelPath};`);
+      }
+      if (configName.includes("name = Debug;") && !settings.some((setting) => setting.includes("CODE_SIGN_ALLOW_ENTITLEMENTS_MODIFICATION"))) {
+        insertSettings.push(`${indent}CODE_SIGN_ALLOW_ENTITLEMENTS_MODIFICATION = YES;`);
+      }
+      if (insertSettings.length > 0) {
+        lines.splice(index, 0, ...insertSettings);
+        index += insertSettings.length;
+        changed = true;
+      }
     }
     if (changed)
       await writeFile(pbxprojPath, lines.join(`
 `));
   }
+  async#setCodeSignEntitlementsInIosIfExists(entitlementsRelPath) {
+    const entitlementsPath = path.join(this.app.cwdPath, this.iosProjectPath, entitlementsRelPath);
+    if (!await Bun.file(entitlementsPath).exists())
+      return;
+    await this.#setCodeSignEntitlementsInIos(entitlementsRelPath);
+  }
   async#setUrlSchemesInAndroid(schemes) {
     const manifestPath = path.join(this.app.cwdPath, this.androidRootPath, "app/src/main/AndroidManifest.xml");
     let manifest = await readFile(manifestPath, "utf8");
@@ -1444,4 +1513,4 @@ ${filter}$1`);
   }
 }
 
-export { SWIFTUICORE_MIN_IOS_MAJOR, rootCapacitorConfigFilenames, rootCapacitorConfigPaths, clearRootCapacitorConfigs, writeRootCapacitorConfig, selectLocalDevHost, parseIosRuntimeMajor, sortIosRunTargets, parseDevicectlDevices, parseSimctlDevices, buildIosNativeRunCommand, classifyIosRunFailure, formatIosRunFailureMessage, sanitizeIosNativeRunEnv, PLACEHOLDER_APP_IDS, isPlaceholderAppId, getMissingAndroidReleaseSigningKeys, formatAndroidReleaseSigningError, getAdbDeviceStateIssues, ANDROID_MIN_SDK_VERSION, raiseGradleMinSdkVersion, assertJsonSerializable, materializeCapacitorConfig, CapacitorApp };
+export { SWIFTUICORE_MIN_IOS_MAJOR, rootCapacitorConfigFilenames, rootCapacitorConfigPaths, clearRootCapacitorConfigs, writeRootCapacitorConfig, selectLocalDevHost, parseIosRuntimeMajor, sortIosRunTargets, parseDevicectlDevices, parseSimctlDevices, buildIosNativeRunCommand, classifyIosRunFailure, formatIosRunFailureMessage, sanitizeIosNativeRunEnv, PLACEHOLDER_APP_IDS, isPlaceholderAppId, getMissingAndroidReleaseSigningKeys, formatAndroidReleaseSigningError, getAdbDeviceStateIssues, getAndroidLocalServerHost, ANDROID_MIN_SDK_VERSION, raiseGradleMinSdkVersion, assertJsonSerializable, materializeCapacitorConfig, CapacitorApp };

package/{index-nm6wghb6.js → index-82jrh4hj.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   CloudRunner
-} from "./index-zasydjxd.js";
+} from "./index-4m0bphac.js";
 import {
   PackageScript
-} from "./index-k95xkh4p.js";
+} from "./index-gcv8ncfh.js";
 import {
   AiSession,
   CloudApi,
@@ -12,13 +12,13 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   ApplicationScript
-} from "./index-e16gnn26.js";
+} from "./index-62955kn5.js";
 import {
   script
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   PkgExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/{index-7c6k4yvg.js → index-d43t8af2.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   LibExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/semver.ts
 function parseVersion(version) {

package/{index-ej426mcr.js → index-eyyf2149.js}

@@ -1,22 +1,24 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-a00jg8x8.js";
+} from "./index-774gcx29.js";
 import {
   Prompter
-} from "./index-tdbas9r0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   AGENT_BLOCK_END,
   AGENT_BLOCK_START,
   AppExecutor,
   LibExecutor,
+  readDevkitVersion,
   renderRecipeEntries,
+  stampBlockVersion,
   upsertAgentBlock
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 import {
   collectRecipeSources,
   scanRecipes
@@ -103,19 +105,33 @@ ${scopeIndexPointer}
 
 `;
 };
+var renderGuides = async (context) => {
+  const conventions = (await Prompter.getInstruction("conventions")).trim();
+  if (context.pkgs.some((pkg) => pkg.name === "akanjs"))
+    return conventions;
+  const onboarding = (await Prompter.getInstruction("workspaceOnboarding")).trim();
+  const appName = context.apps[0]?.name ?? "app";
+  return `${conventions}
+
+${onboarding.replaceAll("<%= appName %>", appName)}`;
+};
 var renderManagedBlock = async (workspace) => {
   const context = await AkanContextAnalyzer.analyze(workspace);
   const frameworkGuide = await Prompter.getInstruction("framework");
   const appNames = context.apps.map((app) => app.name);
   const sampleCleanup = await renderSampleCleanup(workspace, appNames);
   const recipeIndex = await renderRecipeIndex(workspace);
-  return `## Workspace
+  const guides = await renderGuides(context);
+  const version = await readDevkitVersion();
+  const block = `## Workspace
 
 - Repo: ${context.repoName}
 - Apps: ${context.apps.map((app) => app.name).join(", ") || "none"}
 - Libraries: ${context.libs.map((lib) => lib.name).join(", ") || "none"}
 - Packages: ${context.pkgs.map((pkg) => pkg.name).join(", ") || "none"}
 
+${guides}
+
 ${sampleCleanup}## Akan Module Abstracts
 
 - Before changing a domain, service, or scalar module, read its \`*.abstract.md\` file first.
@@ -148,7 +164,19 @@ ${context.validationCommands.map((command) => `- \`${command}\``).join(`
 
 ## Framework Guide
 
-${frameworkGuide.trim()}`;
+${frameworkGuide.trim()}
+
+## Before You Finish
+
+1. \`bun run akan lint <appName>\` \u2014 Tailwind class order, \`Err\`, \`console\`, \`#private\` scope, unused imports.
+2. \`bun run akan typecheck <appName>\` \u2014 server/client boundary violations.
+3. \`bun run akan sync <appName>\` if you added, renamed, or deleted any file.
+4. Did you write or change a \`.tsx\` file? \`bun run akan quality ssr\` \u2014 did the server share hold, and did you add
+   a \`"use client"\` you cannot justify?
+5. Re-read the file you wrote against its section above.
+6. Did you add a comment? Delete it unless it documents an external constraint or a security decision.
+7. Did behavior or an invariant change? Update the module's \`*.abstract.md\`.`;
+  return version ? stampBlockVersion(block, version) : block;
 };
 var renderAgentsMd = async (workspace, existing) => {
   const block = await renderManagedBlock(workspace);

package/{index-k95xkh4p.js → index-gcv8ncfh.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-kdh76j26.js";
 import {
   PkgExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-z8ptfkzv.js";
 import {
   TypeScriptDependencyScanner
 } from "./index-46tjzh6s.js";

package/{index-tdbas9r0.js → index-j37qq1f2.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   getDirname
-} from "./index-hgna5rjy.js";
+} from "./index-1577bej2.js";
 
 // pkgs/@akanjs/devkit/prompter.ts
 import fsPromise from "fs/promises";