@akanjs/cli 3.0.0-alpha.8 → 3.0.0-alpha.9

package/incrementalBuilder.proc.js

@@ -16,8 +16,9 @@ import {
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-vg0sj9nc.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-bz2sfzzt.js → index-3vta1tqa.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-vtj3zps1.js";
+} from "./index-jhpa13zj.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-2c3e2xh8.js";
+} from "./index-rxkpk7n4.js";
 import {
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

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

@@ -7,14 +7,14 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   openBrowser
-} from "./index-5dw57f0d.js";
+} from "./index-62955kn5.js";
 import {
   runner
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
 import path from "path";

package/{index-w6wbb612.js → index-5sn5w2mt.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   RepairRunner
-} from "./index-ztpw544k.js";
+} from "./index-jf2ya7r2.js";
 import {
   WorkflowRunner
-} from "./index-5pmx7bkg.js";
+} from "./index-qzdjd4ct.js";
+import {
+  ScalarScript
+} from "./index-y4vkyhvv.js";
 import {
   PrimitiveScript
-} from "./index-bz2sfzzt.js";
+} from "./index-3vta1tqa.js";
 import {
   ModuleScript
-} from "./index-vtj3zps1.js";
-import {
-  ScalarScript
-} from "./index-gmy45vz2.js";
+} from "./index-jhpa13zj.js";
 import {
   isPlaceholderAppId
-} from "./index-xhgtkekh.js";
+} from "./index-779ske1y.js";
 import {
   AkanContextAnalyzer,
   akanMcpInstallConfigPaths,
@@ -27,17 +27,17 @@ import {
   renderDoctorText,
   resourceList,
   upsertCodexMcpServerBlock
-} from "./index-mssqn2sq.js";
+} from "./index-774gcx29.js";
 import {
   buildAkanModuleContextIndex,
   createWorkflowBaselineSummary,
   createWorkflowStepRegistry,
   jsonText,
   toolingRolloutGate
-} from "./index-2c3e2xh8.js";
+} from "./index-rxkpk7n4.js";
 import {
   Prompter
-} from "./index-7myvn0f0.js";
+} from "./index-j37qq1f2.js";
 import {
   getMobileTargets
 } from "./index-76rn3g2c.js";
@@ -45,10 +45,10 @@ import {
   CommandContainer,
   runner,
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 import {
   AppExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-5dw57f0d.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-a1e0j63x.js";
 import {
   runner,
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 import {
   HmrWatcher,
   WatchRootResolver
@@ -18,7 +18,7 @@ import {
   LibExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 import {
   __require
 } from "./index-r24hmh0q.js";
@@ -1900,7 +1900,7 @@ function openBrowser(url) {
 // pkgs/@akanjs/cli/application/application.runner.ts
 var loadBuildRunner = async () => (await import("./applicationBuildRunner-ha3y8ew8.js")).ApplicationBuildRunner;
 var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-p0z5yab2.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-mssqn2sq.js → index-774gcx29.js}

@@ -2,14 +2,16 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-2c3e2xh8.js";
+} from "./index-rxkpk7n4.js";
 import {
   AppExecutor,
   LibExecutor,
   appRootAllowedDirs,
   appRootAllowedFiles,
-  isScannedAppRootEntry
-} from "./index-vg0sj9nc.js";
+  extractBlockVersion,
+  isScannedAppRootEntry,
+  readDevkitVersion
+} from "./index-z8ptfkzv.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,
@@ -124,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",
@@ -365,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,
@@ -396,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-xhgtkekh.js → index-779ske1y.js}

@@ -5,7 +5,7 @@ import {
 } from "./index-76rn3g2c.js";
 import {
   CommandExecutionError
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp, mkdir, readFile, rm, writeFile } from "fs/promises";

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

@@ -1,10 +1,10 @@
 // @bun
 import {
   CloudRunner
-} from "./index-p3f4q532.js";
+} from "./index-4m0bphac.js";
 import {
   PackageScript
-} from "./index-azv0xjb5.js";
+} from "./index-gcv8ncfh.js";
 import {
   AiSession,
   CloudApi,
@@ -12,13 +12,13 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   ApplicationScript
-} from "./index-5dw57f0d.js";
+} from "./index-62955kn5.js";
 import {
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 import {
   PkgExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/{index-a1e0j63x.js → index-d43t8af2.js}

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

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

@@ -1,22 +1,24 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-mssqn2sq.js";
+} from "./index-774gcx29.js";
 import {
   Prompter
-} from "./index-7myvn0f0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 import {
   AGENT_BLOCK_END,
   AGENT_BLOCK_START,
   AppExecutor,
   LibExecutor,
+  readDevkitVersion,
   renderRecipeEntries,
+  stampBlockVersion,
   upsertAgentBlock
-} from "./index-vg0sj9nc.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-azv0xjb5.js → index-gcv8ncfh.js}

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

package/{index-7myvn0f0.js → index-j37qq1f2.js}

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

package/{index-ztpw544k.js → index-jf2ya7r2.js}

@@ -1,17 +1,17 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-mssqn2sq.js";
+} from "./index-774gcx29.js";
 import {
   createRepairReport,
   generatedFilePathsForTarget,
   renderRepairReport,
   writeGeneratedSyncState,
   writeWorkflowRunArtifact
-} from "./index-2c3e2xh8.js";
+} from "./index-rxkpk7n4.js";
 import {
   runner
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/{index-vtj3zps1.js → index-jhpa13zj.js}

@@ -1,10 +1,10 @@
 // @bun
-import {
-  PageScript
-} from "./index-4hek879p.js";
 import {
   pluralizeName
 } from "./index-ss469dec.js";
+import {
+  PageScript
+} from "./index-xmmzf150.js";
 import {
   AiSession
 } from "./index-0cj2zxbm.js";
@@ -15,17 +15,17 @@ import {
   generatedFilesForSync,
   moduleSourcePaths,
   sourceFile
-} from "./index-2c3e2xh8.js";
+} from "./index-rxkpk7n4.js";
 import {
   Prompter
-} from "./index-7myvn0f0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 import {
   ModuleExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-6rhabeev.js → index-kdh76j26.js}

@@ -5,9 +5,11 @@ import {
   LibExecutor,
   ModuleExecutor,
   PkgExecutor,
-  WorkspaceExecutor,
+  WorkspaceExecutor
+} from "./index-z8ptfkzv.js";
+import {
   getDirname
-} from "./index-vg0sj9nc.js";
+} from "./index-1577bej2.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-5pmx7bkg.js → index-qzdjd4ct.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-mssqn2sq.js";
+} from "./index-774gcx29.js";
 import {
   WorkflowExecutor,
   compactWorkflowInputs,
@@ -23,10 +23,10 @@ import {
   workflowCommandsForPlan,
   workflowPlanApproval,
   writeWorkflowRunArtifact
-} from "./index-2c3e2xh8.js";
+} from "./index-rxkpk7n4.js";
 import {
   runner
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-2c3e2xh8.js → index-rxkpk7n4.js}

@@ -2,7 +2,7 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-z8ptfkzv.js";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `

package/{index-4hek879p.js → index-xmmzf150.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 
 // pkgs/@akanjs/cli/page/page.runner.ts
 class PageRunner extends runner("page") {

package/{index-gmy45vz2.js → index-y4vkyhvv.js}

@@ -9,14 +9,14 @@ import {
   createPassedPrimitiveReport,
   generatedFilesForSync,
   scalarChangedFiles
-} from "./index-2c3e2xh8.js";
+} from "./index-rxkpk7n4.js";
 import {
   Prompter
-} from "./index-7myvn0f0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-6rhabeev.js";
+} from "./index-kdh76j26.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
 import { input } from "@inquirer/prompts";