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

package/{index-t3723f99.js → index-1yxtbmbj.js}

@@ -1,11 +1,11 @@
 // @bun
+import {
+  CommandExecutionError
+} from "./index-qsq3q8fy.js";
 import {
   resolveMobilePath,
   targetHtmlFilename
-} from "./index-76rn3g2c.js";
-import {
-  CommandExecutionError
-} from "./index-hgna5rjy.js";
+} from "./index-47pj3aee.js";
 
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp, mkdir, readFile, rm, writeFile } from "fs/promises";
@@ -17,22 +17,22 @@ import { capitalize } from "akanjs/common";
 
 // pkgs/@akanjs/devkit/fileEditor.ts
 class FileEditor {
-  filePath;
-  content;
+  #filePath;
+  #content;
   constructor(filePath, content) {
-    this.filePath = filePath;
-    this.content = content;
+    this.#filePath = filePath;
+    this.#content = content;
   }
   static async create(filePath) {
     try {
       const content = await Bun.file(filePath).text();
       return new FileEditor(filePath, content);
-    } catch (error) {
+    } catch (_error) {
       throw new Error(`Failed to read file: ${filePath}`);
     }
   }
   find(pattern) {
-    const lines = this.content.split(`
+    const lines = this.#content.split(`
 `);
     const regex = typeof pattern === "string" ? new RegExp(pattern) : pattern;
     for (let i = 0;i < lines.length; i++) {
@@ -45,7 +45,7 @@ class FileEditor {
     return -1;
   }
   findAll(pattern) {
-    const lines = this.content.split(`
+    const lines = this.#content.split(`
 `);
     const regex = typeof pattern === "string" ? new RegExp(pattern) : pattern;
     const matches = [];
@@ -63,10 +63,10 @@ class FileEditor {
     if (lineIndex === -1) {
       throw new Error(`Pattern not found: ${pattern}`);
     }
-    const lines = this.content.split(`
+    const lines = this.#content.split(`
 `);
     lines.splice(lineIndex + 1, 0, data);
-    this.content = lines.join(`
+    this.#content = lines.join(`
 `);
     return this;
   }
@@ -75,40 +75,40 @@ class FileEditor {
     if (lineIndex === -1) {
       throw new Error(`Pattern not found: ${pattern}`);
     }
-    const lines = this.content.split(`
+    const lines = this.#content.split(`
 `);
     lines.splice(lineIndex, 0, data);
-    this.content = lines.join(`
+    this.#content = lines.join(`
 `);
     return this;
   }
   replace(pattern, replacement) {
     const regex = typeof pattern === "string" ? new RegExp(pattern, "g") : pattern;
-    this.content = this.content.replace(regex, replacement);
+    this.#content = this.#content.replace(regex, replacement);
     return this;
   }
   append(data) {
-    this.content += `
+    this.#content += `
 ${data}`;
     return this;
   }
   prepend(data) {
-    this.content = `${data}
-${this.content}`;
+    this.#content = `${data}
+${this.#content}`;
     return this;
   }
   async save() {
     try {
-      await Bun.write(this.filePath, this.content);
-    } catch (error) {
-      throw new Error(`Failed to save file: ${this.filePath}`);
+      await Bun.write(this.#filePath, this.#content);
+    } catch (_error) {
+      throw new Error(`Failed to save file: ${this.#filePath}`);
     }
   }
   getContent() {
-    return this.content;
+    return this.#content;
   }
   setContent(content) {
-    this.content = content;
+    this.#content = content;
     return this;
   }
 }
@@ -474,7 +474,7 @@ var PLACEHOLDER_APP_IDS = [
   "com.example.myapp"
 ];
 var placeholderAppIdSegment = /^(example|examples|myorg|myapp|mycompany|myorganization|changeme|todo|sample|test)$/;
-var isPlaceholderAppId = (appId) => {
+var isPlaceholderAppId2 = (appId) => {
   const normalized = appId?.trim().toLowerCase() ?? "";
   if (!normalized)
     return true;
@@ -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+)/);
@@ -637,7 +641,7 @@ function materializeCapacitorConfig(target, { operation, localServerUrl, localIp
   return config;
 }
 
-class CapacitorApp {
+class CapacitorApp2 {
   app;
   target;
   project;
@@ -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 { isPlaceholderAppId2, CapacitorApp2 };

package/{index-ej426mcr.js → index-29sxqfaw.js}

@@ -1,26 +1,29 @@
 // @bun
-import {
-  AkanContextAnalyzer
-} from "./index-a00jg8x8.js";
-import {
-  Prompter
-} from "./index-tdbas9r0.js";
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-znynzt5w.js";
 import {
-  AGENT_BLOCK_END,
   AGENT_BLOCK_START,
-  AppExecutor,
-  LibExecutor,
+  AGENT_BLOCK_END,
+  stampBlockVersion,
+  readDevkitVersion,
+  upsertAgentBlock,
   renderRecipeEntries,
-  upsertAgentBlock
-} from "./index-hgna5rjy.js";
+  CLAUDE_COMMENT_RULE,
+  AppExecutor,
+  LibExecutor
+} from "./index-qsq3q8fy.js";
+import {
+  collectRecipeSources2,
+  scanRecipes2
+} from "./index-by5gpp8x.js";
 import {
-  collectRecipeSources,
-  scanRecipes
-} from "./index-xys926f2.js";
+  AkanContextAnalyzer
+} from "./index-gtmz74tj.js";
+import {
+  Prompter
+} from "./index-h7yw2z9n.js";
 
 // pkgs/@akanjs/cli/agent/agent.script.ts
 import { Logger as Logger2 } from "akanjs/common";
@@ -74,8 +77,8 @@ Keep a sample only while you are still learning its pattern; delete it once your
 `;
 };
 var renderRecipeIndex = async (workspace) => {
-  const sources = await collectRecipeSources(`${workspace.workspaceRoot}/pkgs/akanjs/ui`, "akanjs/ui", "recipe");
-  const recipes = scanRecipes(sources);
+  const sources = await collectRecipeSources2(`${workspace.workspaceRoot}/pkgs/akanjs/ui`, "akanjs/ui", "recipe");
+  const recipes = scanRecipes2(sources);
   const scopeIndexPointer = `App and lib recipes are **not** listed here. Each app/lib carries its own generated index \u2014
 \`apps/<app>/AGENTS.md\` / \`libs/<lib>/AGENTS.md\` (\`## Recipes In Scope\`) \u2014 regenerated by \`akan sync\` and
 verified by \`akan lint\`. When working inside an app or lib, consult that file before consuming or authoring a look.`;
@@ -87,15 +90,14 @@ ${scopeIndexPointer}
 `;
   return `## Recipes
 
-Framework UI recipes (Tailwind-variant look factories), importable from every app and lib. Consume by exact name \u2014
-\`import { <name> } from "akanjs/ui"\`, then \`<name>(variants?, className?)\`. The second arg merges internally and
-takes **an array too**, so never wrap it in \`cn()\`: \`<name>({}, ["h-full", isWide && "w-full", className])\`.
-Do not guess recipe names, import paths, or variant values; the list below carries
-the full contract (\`*\` marks the default, \`key?\` is a boolean flag), so there is no need to open the recipe file to
-consume one. tsc still reports variant mistakes. **Before inlining a repeated surface (card, box,
-tile, \u2026): reuse a recipe, or add one as \`apps/<app>/ui/Recipe/<name>.ts\` (one recipe per file, re-exported from
-that folder's \`index.ts\`) \u2014 never re-implement the same look inline in several places, and never author a
-near-duplicate.** Full authoring/consumption policy: the \`recipeRule\` guideline.
+Framework UI recipes (Tailwind-variant look factories), importable from every app and lib: \`import { <name> } from
+"akanjs/ui"\`, then \`<name>(variants?, className?)\`. The second arg merges internally and takes **an array too**, so
+never wrap it in \`cn()\`: \`<name>({}, ["h-full", isWide && "w-full", className])\`. The list below is the full
+contract (\`*\` marks the default, \`key?\` is a boolean flag) \u2014 do not guess a name, path, or variant value, and do
+not open the recipe file to consume one. **Before inlining a repeated surface (card, box, tile, \u2026): reuse a recipe,
+or add one as \`apps/<app>/ui/Recipe/<name>.ts\`, one per file, re-exported from that folder's \`index.ts\` \u2014 never
+re-implement the same look inline in several places, and never author a near-duplicate.** Full policy: the
+\`recipeRule\` guideline.
 
 ${renderRecipeEntries(recipes)}
 
@@ -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.
@@ -131,15 +147,12 @@ If generated output is stale or broken, update the owning source file and run \`
 
 ${recipeIndex}## MCP Workflow Policy
 
-- Prefer Akan MCP workflows before direct source edits.
-- Direct source edits are denied when an allowlisted Akan workflow or repair tool can perform the change.
-- Use \`akan mcp --mode plan\` to inspect \`list_workflows\`, \`explain_workflow\`, and \`plan_workflow\`.
-- If \`plan_workflow\` returns \`planPath\` or \`next.tool=apply_workflow\`, call \`apply_workflow({ planPath })\` before editing source files directly.
-- Use \`akan mcp --mode apply\` only for allowlisted \`apply_workflow\`, \`run_validation\`, and repair tools.
-- After \`apply_workflow\`, run \`run_validation\` with \`validationTarget\` when present; otherwise use \`applyReportPath\`.
-- If no workflow exists, or apply reports unsupported/no-op/failed diagnostics that require manual action, keep edits scoped to owning source files and never patch generated files directly.
-- For compound requests, split the request into workflows and apply each \`planPath\` in order, such as \`create-module\` followed by \`add-field\`.
-- **CLI-only fallback (MCP not connected):** \`akan mcp\` starts a stdio MCP server, so the \`list_workflows\`/\`plan_workflow\`/\`apply_workflow\` tools exist only when your agent is wired to it as an MCP client. When they are unavailable, the CLI is a first-class equivalent: \`akan workflow list\` / \`explain <name>\` / \`plan <name> ... --format json --out <planPath>\` / \`apply <planPath> --format json\`, \`akan doctor --strict --format json\` for validation, and \`akan repair generated|imports|module-shape --app <app> --format json\` for repairs. Scaffolding primitives (\`create-module\`/\`create-scalar\`/\`create-service\` take the target app/lib as a POSITIONAL arg; \`add-field\`/\`add-enum-field\` use \`--app\`/\`--module\` flags) call the same code the workflows do.
+- **Prefer an Akan workflow to a direct source edit.** A direct edit is denied when an allowlisted workflow or repair tool can make the change.
+- Inspect with \`akan mcp --mode plan\` (\`list_workflows\`, \`explain_workflow\`, \`plan_workflow\`); apply with \`akan mcp --mode apply\`, which allowlists \`apply_workflow\`, \`run_validation\`, and the repair tools.
+- If \`plan_workflow\` returns \`planPath\` or \`next.tool=apply_workflow\`, call \`apply_workflow({ planPath })\` before editing source. Then run \`run_validation\` with \`validationTarget\` when present, otherwise \`applyReportPath\`.
+- Split a compound request into workflows and apply each \`planPath\` in order, such as \`create-module\` followed by \`add-field\`.
+- When no workflow exists, or apply reports unsupported/no-op/failed diagnostics needing manual action, keep edits scoped to owning source files and never patch generated files directly.
+- **MCP not connected?** The CLI is a first-class equivalent \u2014 \`akan workflow list\` / \`explain\` / \`plan\` / \`apply\`, \`akan doctor\`, \`akan repair\`. See the onboarding guide's CLI-only fallback for the exact flags.
 
 ## Validation
 
@@ -148,7 +161,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);
@@ -171,6 +196,8 @@ var renderClaudeMd = async (workspace) => {
   return `# ${context.repoName} \u2014 Claude Code Guide
 
 @AGENTS.md
+
+${CLAUDE_COMMENT_RULE}
 `;
 };
 var renderCursorRule = () => `---
@@ -218,7 +245,7 @@ class AgentRunner extends runner("agent") {
         written.push(`${exec.type}s/${exec.name}/AGENTS.md`);
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        Logger.rawLog(`Skipped ${exec.type}s/${exec.name}/AGENTS.md (${message})`, undefined, "warn");
+        Logger.rawLog(`Skipped ${exec.type}s/${exec.name}/AGENTS.md (${message})`, undefined, "error");
       }
     };
     for (const name of libNames)

package/index-3d9y066c.js

@@ -0,0 +1,76 @@
+// @bun
+// pkgs/@akanjs/devkit/libSource.ts
+class LibSource {
+  static manifestKey = "akan";
+  static unhashedDirs = ["env"];
+  #lib;
+  constructor(lib) {
+    this.#lib = lib;
+  }
+  get #prefix() {
+    return `libs/${this.#lib.name}/`;
+  }
+  #isHashed(file) {
+    const relative = file.slice(this.#prefix.length);
+    return !LibSource.unhashedDirs.includes(relative.split("/")[0] ?? "");
+  }
+  async#hashableContent(file) {
+    const content = await this.#lib.workspace.readFile(file);
+    if (file !== `${this.#prefix}package.json`)
+      return content;
+    const manifest = JSON.parse(content);
+    delete manifest[LibSource.manifestKey];
+    return JSON.stringify(manifest);
+  }
+  async computeHash() {
+    const files = (await this.#lib.workspace.listGitFiles([`libs/${this.#lib.name}`], { untracked: true })).filter((file) => this.#isHashed(file));
+    const hasher = new Bun.CryptoHasher("sha256");
+    for (const file of files) {
+      hasher.update(file);
+      hasher.update("\x00");
+      hasher.update(await this.#hashableContent(file));
+      hasher.update("\x00");
+    }
+    return hasher.digest("hex").slice(0, 32);
+  }
+  async read() {
+    const manifest = await this.#lib.getPackageJson();
+    const akan = manifest[LibSource.manifestKey];
+    return akan?.source ?? null;
+  }
+  async write({ origin, sha }) {
+    const [manifest, hash] = await Promise.all([this.#lib.getPackageJson(), this.computeHash()]);
+    const akan = manifest[LibSource.manifestKey] ?? {};
+    const stamp = { origin, sha, hash, syncedAt: new Date().toISOString() };
+    await this.#lib.setPackageJson({ ...manifest, [LibSource.manifestKey]: { ...akan, source: stamp } });
+    return stamp;
+  }
+  async syncStamp({ origin, sha }) {
+    const [current, hash] = await Promise.all([this.read(), this.computeHash()]);
+    if (current?.origin === origin && current.sha === sha && current.hash === hash)
+      return { stamp: current, changed: false };
+    return { stamp: await this.write({ origin, sha }), changed: true };
+  }
+  async status() {
+    const [stamp, hash] = await Promise.all([this.read(), this.computeHash()]);
+    const drift = !stamp ? "unstamped" : stamp.hash === hash ? "clean" : "drifted";
+    return { lib: this.#lib.name, drift, stamp, hash };
+  }
+}
+function formatLibStatuses(statuses) {
+  const marks = { clean: "clean    ", drifted: "DRIFTED  ", unstamped: "unstamped" };
+  const sections = [
+    "Akan Library Source Status",
+    "",
+    ...statuses.map((status) => {
+      const origin = status.stamp ? `${status.stamp.origin}@${status.stamp.sha}` : "no akan.source in package.json";
+      return `  ${marks[status.drift]} libs/${status.lib}  ${origin}`;
+    }),
+    "",
+    `drifted: ${statuses.filter((status) => status.drift === "drifted").length} / ${statuses.length}`
+  ];
+  return sections.join(`
+`);
+}
+
+export { LibSource, formatLibStatuses };

package/{index-76rn3g2c.js → index-47pj3aee.js}

@@ -37,10 +37,10 @@ var resolveMobileTargets = async (app, selection) => {
   if (!selection && targets.length === 1)
     return targets;
   if (!selection) {
-    const choices2 = await getMobileTargetChoices(app);
-    if (choices2.length === 1)
-      return resolveMobileTargets(app, choices2[0]);
-    throw new Error(`Multiple mobile targets found for ${app.name}. Pass --target <${choices2.join("|")}|all>.`);
+    const choices = await getMobileTargetChoices(app);
+    if (choices.length === 1)
+      return resolveMobileTargets(app, choices[0]);
+    throw new Error(`Multiple mobile targets found for ${app.name}. Pass --target <${choices.join("|")}|all>.`);
   }
   if (selection === "all") {
     if (Object.keys(config.mobile.targets).length > 1)