@akanjs/cli 2.4.2-rc.2 → 2.4.2-rc.3

package/.build-stamp

@@ -1 +1 @@
-6f93500c73ae1edf5c631b83d87c67fb74323b45daf56ae9a89e6c48596c14b8
+521ade138cb20f2efa62ad3bbf6f52195b7e4717e808fb5a3808f73ede5cb3f0

package/abstractCompactor-ghh1q9an.js

@@ -0,0 +1,103 @@
+// @bun
+import {
+  AbstractDoc
+} from "./index-0wae5ebk.js";
+import {
+  AiSession
+} from "./index-nsj2ftxj.js";
+import"./index-67546d0j.js";
+import"./index-6pz1j0zj.js";
+import"./index-r24hmh0q.js";
+
+// pkgs/@akanjs/devkit/abstractCompactor.ts
+import { Logger } from "akanjs/common";
+import chalk from "chalk";
+class AbstractCompactor {
+  static #reviewRequest = `Review the compacted file you just wrote against the original.
+- Did you drop an invariant, a security reason, or a workflow step that the source files cannot show by themselves? Restore it.
+- Did you keep anything that only restates code, scaffold wording, or history? Remove it.
+- Is it in the same language as the original, within the line budget, and one short line per bullet?
+Respond with exactly one \`\`\`markdown code block holding the corrected file and nothing else. If nothing needs to change, repeat the file unchanged.`;
+  #sys;
+  #minLines;
+  #interactive;
+  constructor(sys, { minLines = AbstractDoc.compactMinLines, interactive = false } = {}) {
+    this.#sys = sys;
+    this.#minLines = minLines;
+    this.#interactive = interactive;
+  }
+  async compactAll({ module } = {}) {
+    const docs = await AbstractDoc.findAll(this.#sys, { module });
+    const targets = docs.filter((doc) => doc.lineCount > this.#minLines);
+    const reports = [];
+    for (const doc of targets)
+      reports.push(await this.compact(doc));
+    return { scanned: docs.length, reports };
+  }
+  async compact(doc) {
+    const session = new AiSession("compactAbstract", {
+      workspace: this.#sys.workspace,
+      cacheKey: `${this.#sys.name}-${doc.moduleName}`
+    });
+    const approve = !this.#interactive;
+    const compacted = await session.editMarkdown(this.#request(doc), { approve });
+    const reviewed = await session.editMarkdown(AbstractCompactor.#reviewRequest, { approve });
+    const next = [reviewed, compacted].map((candidate) => candidate.trim()).find((candidate) => doc.canReplaceWith(candidate));
+    const beforeLines = doc.lineCount;
+    if (!next) {
+      Logger.rawLog(chalk.yellow(`${doc.path}: the editor returned no shorter abstract, keeping the current file`));
+      return { path: doc.path, beforeLines, afterLines: beforeLines, status: "failed" };
+    }
+    if (next === doc.content.trim())
+      return { path: doc.path, beforeLines, afterLines: beforeLines, status: "unchanged" };
+    const content = `${next}
+`;
+    await this.#sys.writeFile(doc.path, content);
+    return { path: doc.path, beforeLines, afterLines: AbstractDoc.lineCountOf(content), status: "compacted" };
+  }
+  #targetShape(kind) {
+    if (kind === "other")
+      return "  - keep the headings that still carry information and drop the rest; do not impose a new structure";
+    return [
+      "  - `# <name> Abstract` title line",
+      "  - one declarative sentence naming what this module owns",
+      "  - `## Rules` \u2014 two to five bullets, each an invariant the code cannot show by itself",
+      "  - optional `## Workflow` \u2014 the lifecycle as an arrow chain (`draft -> signed -> active`) or a few bullets"
+    ].join(`
+`);
+  }
+  #request(doc) {
+    return `You are compacting an Akan.js abstract file.
+
+An abstract is the summary a coding agent reads before changing a module. Repeated edits have made this one
+bloated, and it has to shrink back to what the source files cannot show by themselves.
+
+# Target file
+${this.#sys.type}s/${this.#sys.name}/${doc.path} (${doc.kind} module "${doc.moduleName}", ${doc.lineCount} lines)
+
+# Source files in the same folder
+${doc.siblingFiles.join(", ") || "none"}
+
+# Current content
+\`\`\`markdown
+${doc.content}
+\`\`\`
+
+# Rules for the compacted file
+- Write it in the SAME language as the current content. Never translate.
+- Keep every invariant, constraint, security reason, and workflow step that the source files cannot show by
+  themselves. Merge duplicates instead of dropping either one.
+- Delete what the code already states: field lists, types, labels, signatures, file lists, and imports.
+- Delete scaffold and placeholder wording, changelog or migration history, TODOs, and any instruction about
+  reading or updating this file.
+- Never invent a rule that the current content does not state.
+- Keep every bullet to one short line, and stay under ${AbstractDoc.compactMinLines} lines in total.
+- Shape:
+${this.#targetShape(doc.kind)}
+
+Respond with exactly one \`\`\`markdown code block holding the whole new file and nothing else.`;
+  }
+}
+export {
+  AbstractCompactor
+};

package/{agent.command-ej4g9pbb.js → agent.command-de4r6vk8.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AgentScript
-} from "./index-40w1kqp1.js";
+} from "./index-zn9rh7sh.js";
 import"./index-v9jqrdd1.js";
 import"./index-pfnh87f9.js";
 import"./index-xftstr5s.js";

package/{application.command-smn51a28.js → application.command-nfsfm96y.js}

@@ -1,7 +1,10 @@
 // @bun
+import {
+  AbstractDoc
+} from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-panyahn4.js";
+} from "./index-fbv96xaw.js";
 import {
   getMobileTargetChoices
 } from "./index-76rn3g2c.js";
@@ -39,6 +42,13 @@ class ApplicationCommand extends command("application", [ApplicationScript], ({
   sync: target({ desc: "Sync dependencies and configuration for an app or library" }).with(Sys).exec(async function(sys) {
     await this.applicationScript.sync(sys);
   }),
+  compact: target({ desc: "Compact the *.abstract.md files of an app or library with the AI editor" }).with(Sys).option("module", String, { desc: "single module to compact", nullable: true }).option("minLines", Number, {
+    flag: "n",
+    desc: "only compact abstracts longer than this",
+    default: AbstractDoc.compactMinLines
+  }).option("interactive", Boolean, { desc: "confirm or refine each rewrite", default: false }).exec(async function(sys, module, minLines, interactive) {
+    await this.applicationScript.compact(sys, { module, minLines, interactive });
+  }),
   script: target({ desc: "Run a custom script in the application" }).with(App).arg("filename", String, { desc: "name of script", nullable: true }).exec(async function(app, filename) {
     await this.applicationScript.script(app, filename);
   }),

package/{cloud.command-2v7ga38h.js → cloud.command-1qf95x67.js}

@@ -1,15 +1,15 @@
 // @bun
 import {
   CloudScript
-} from "./index-majzj044.js";
-import"./index-j3j3qc9j.js";
+} from "./index-h6eav7zx.js";
+import"./index-h5cvg9z9.js";
+import"./index-z36qzgzp.js";
 import {
   GlobalConfig
 } from "./index-nsj2ftxj.js";
-import"./index-panyahn4.js";
+import"./index-fbv96xaw.js";
 import"./index-76rn3g2c.js";
 import"./index-s9s0n5fz.js";
-import"./index-z36qzgzp.js";
 import {
   Workspace,
   command

package/commandManifest.json

@@ -1 +1 @@
-{"byCommand":{"create-workspace":"workspace","generate-agent-rules":"workspace","lint":"workspace","lint-all":"workspace","sync-all":"workspace","init":"workspace","agent":"agent","create-application":"application","remove-application":"application","sync":"application","script":"application","console":"application","build":"application","b":"application","typecheck":"application","t":"application","test":"application","build-ios":"application","bi":"application","build-android":"application","ba":"application","start":"application","s":"application","start-ios":"application","si":"application","start-android":"application","sa":"application","release-ios":"application","release-android":"application","release-source":"application","codepush":"application","dbup":"application","dbdown":"application","configure-app":"application","create-library":"library","remove-library":"library","sync-library":"library","install-library":"library","start-registry":"localRegistry","reset-registry":"localRegistry","smoke-registry":"localRegistry","version":"package","create-package":"package","remove-package":"package","sync-package":"package","build-package":"package","verify-dist-package":"package","verify-akan-publish-packages":"package","create-module":"module","remove-module":"module","create-service":"module","create-view":"module","create-unit":"module","create-template":"module","create-crud-page":"page","context":"context","doctor":"context","mcp-install":"context","mcp":"context","mcp-call":"context","login":"cloud","logout":"cloud","set-llm":"cloud","reset-llm":"cloud","ask":"cloud","deploy-akan":"cloud","update":"cloud","download-env":"cloud","upload-env":"cloud","guideline":"guideline","generate-instruction":"guideline","update-instruction":"guideline","generate-document":"guideline","reapply-instruction":"guideline","create-scalar":"scalar","remove-scalar":"scalar","create-ui":"primitive","add-field":"primitive","add-enum-field":"primitive","quality":"quality","repair":"repair","workflow":"workflow"}}
+{"byCommand":{"create-workspace":"workspace","generate-agent-rules":"workspace","lint":"workspace","lint-all":"workspace","sync-all":"workspace","init":"workspace","agent":"agent","create-application":"application","remove-application":"application","sync":"application","compact":"application","script":"application","console":"application","build":"application","b":"application","typecheck":"application","t":"application","test":"application","build-ios":"application","bi":"application","build-android":"application","ba":"application","start":"application","s":"application","start-ios":"application","si":"application","start-android":"application","sa":"application","release-ios":"application","release-android":"application","release-source":"application","codepush":"application","dbup":"application","dbdown":"application","configure-app":"application","create-library":"library","remove-library":"library","sync-library":"library","install-library":"library","start-registry":"localRegistry","reset-registry":"localRegistry","smoke-registry":"localRegistry","version":"package","create-package":"package","remove-package":"package","sync-package":"package","build-package":"package","verify-dist-package":"package","verify-akan-publish-packages":"package","create-module":"module","remove-module":"module","create-service":"module","create-view":"module","create-unit":"module","create-template":"module","create-crud-page":"page","context":"context","doctor":"context","mcp-install":"context","mcp":"context","mcp-call":"context","login":"cloud","logout":"cloud","set-llm":"cloud","reset-llm":"cloud","ask":"cloud","deploy-akan":"cloud","update":"cloud","download-env":"cloud","upload-env":"cloud","guideline":"guideline","generate-instruction":"guideline","update-instruction":"guideline","generate-document":"guideline","reapply-instruction":"guideline","create-scalar":"scalar","remove-scalar":"scalar","create-ui":"primitive","add-field":"primitive","add-enum-field":"primitive","quality":"quality","repair":"repair","workflow":"workflow"}}

package/index-0wae5ebk.js

@@ -0,0 +1,65 @@
+// @bun
+// pkgs/@akanjs/devkit/abstractDoc.ts
+class AbstractDoc {
+  path;
+  content;
+  siblingFiles;
+  static suffix = ".abstract.md";
+  static maxLines = 300;
+  static compactMinLines = 40;
+  static #facetRoots = "{lib,ui,webkit,srvkit,common,plugin}";
+  static isAbstractPath(filePath) {
+    return filePath.endsWith(AbstractDoc.suffix);
+  }
+  static lineCountOf(content) {
+    return content.split(/\r?\n/).length;
+  }
+  static kindOf(filePath) {
+    const [root, folder, ...rest] = filePath.split("/");
+    if (root !== "lib" || !folder)
+      return "other";
+    if (folder === "__scalar")
+      return rest.length === 2 ? "scalar" : "other";
+    if (rest.length !== 1)
+      return "other";
+    return folder.startsWith("_") ? "service" : "domain";
+  }
+  static async findAll(sys, { module } = {}) {
+    const filePaths = (await sys.getAllFiles(`${AbstractDoc.#facetRoots}/**/*${AbstractDoc.suffix}`)).sort();
+    const docs = await Promise.all(filePaths.map((filePath) => AbstractDoc.read(sys, filePath)));
+    if (!module)
+      return docs;
+    return docs.filter((doc) => doc.moduleName === module || doc.folderName === module);
+  }
+  static async read(sys, filePath) {
+    const dirPath = filePath.split("/").slice(0, -1).join("/");
+    const [content, folderFiles] = await Promise.all([sys.readFile(filePath), sys.readdir(dirPath)]);
+    return new AbstractDoc(filePath, content, folderFiles.filter((fileName) => !AbstractDoc.isAbstractPath(fileName)));
+  }
+  constructor(path, content, siblingFiles) {
+    this.path = path;
+    this.content = content;
+    this.siblingFiles = siblingFiles;
+  }
+  get kind() {
+    return AbstractDoc.kindOf(this.path);
+  }
+  get folderName() {
+    return this.path.split("/").at(-2) ?? "";
+  }
+  get moduleName() {
+    return (this.path.split("/").at(-1) ?? "").slice(0, -AbstractDoc.suffix.length);
+  }
+  get lineCount() {
+    return AbstractDoc.lineCountOf(this.content);
+  }
+  canReplaceWith(candidate) {
+    const next = candidate.trim();
+    if (!next.startsWith("#"))
+      return false;
+    const lineCount = AbstractDoc.lineCountOf(next);
+    return lineCount >= 3 && lineCount < this.lineCount;
+  }
+}
+
+export { AbstractDoc };

package/{index-panyahn4.js → index-fbv96xaw.js}

@@ -1901,6 +1901,7 @@ function openBrowser(url) {
 var loadBuildRunner = async () => (await import("./applicationBuildRunner-554a2vnk.js")).ApplicationBuildRunner;
 var loadReleasePackager = async () => (await import("./applicationReleasePackager-pjbxc793.js")).ApplicationReleasePackager;
 var loadCapacitorApp = async () => (await import("./capacitorApp-yg9b4ajz.js")).CapacitorApp;
+var loadAbstractCompactor = async () => (await import("./abstractCompactor-ghh1q9an.js")).AbstractCompactor;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {
@@ -1978,6 +1979,10 @@ try {
   async typecheck(app, options = {}) {
     await new (await loadBuildRunner())(app).typecheck(options);
   }
+  async compact(sys, { module, minLines, interactive } = {}) {
+    const compactor = new (await loadAbstractCompactor())(sys, { minLines, interactive });
+    return await compactor.compactAll({ module });
+  }
   async test(exec) {
     const isSignalTarget = exec instanceof AppExecutor || exec instanceof LibExecutor;
     const preloadPath = isSignalTarget ? await resolveSignalTestPreloadPath(exec) : null;
@@ -2231,9 +2236,7 @@ ${detail}`
     const chain = RunnableSequence.from([mainPrompt, chatModel, new StringOutputParser]);
     await chain.invoke({ projectName, projectDesc });
     spinner.succeed("Loading complete!");
-    //! add path in tsconfig.json
   }
-  async testApplication(app) {}
 }
 
 // pkgs/@akanjs/cli/application/application.script.ts
@@ -2331,6 +2334,17 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     else
       await this.libraryScript.syncLibrary(sys);
   }
+  async compact(sys, { module = null, minLines, interactive = false } = {}) {
+    const { scanned, reports } = await this.applicationRunner.compact(sys, { module, minLines, interactive });
+    if (!reports.length) {
+      Logger5.rawLog(`No abstract file long enough to compact in ${sys.name} (${scanned} scanned)`);
+      return;
+    }
+    for (const report of reports)
+      Logger5.rawLog(`${report.status}: ${report.path} (${report.beforeLines} -> ${report.afterLines} lines)`);
+    const compactedNum = reports.filter((report) => report.status === "compacted").length;
+    Logger5.rawLog(`Compacted ${compactedNum}/${reports.length} abstract files in ${sys.name}`);
+  }
   async script(app, filename) {
     const scriptFilename = filename ?? await this.applicationRunner.getScriptFilename(app);
     await app.scanSync();
@@ -2515,7 +2529,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
   }
   async testApplication(app) {
     const spinner = app.spinning("Testing application...");
-    await this.applicationRunner.testApplication(app);
+    await this.applicationRunner.test(app);
     spinner.succeed(`Application ${app.name} (apps/${app.name}) test is successful`);
   }
 }

package/{index-j3j3qc9j.js → index-h5cvg9z9.js}

@@ -7,7 +7,7 @@ import {
 } from "./index-nsj2ftxj.js";
 import {
   openBrowser
-} from "./index-panyahn4.js";
+} from "./index-fbv96xaw.js";
 import {
   runner
 } from "./index-d0h48d2f.js";

package/{index-majzj044.js → index-h6eav7zx.js}

@@ -1,7 +1,10 @@
 // @bun
 import {
   CloudRunner
-} from "./index-j3j3qc9j.js";
+} from "./index-h5cvg9z9.js";
+import {
+  PackageScript
+} from "./index-z36qzgzp.js";
 import {
   AiSession,
   CloudApi,
@@ -9,10 +12,7 @@ import {
 } from "./index-nsj2ftxj.js";
 import {
   ApplicationScript
-} from "./index-panyahn4.js";
-import {
-  PackageScript
-} from "./index-z36qzgzp.js";
+} from "./index-fbv96xaw.js";
 import {
   script
 } from "./index-d0h48d2f.js";

package/{index-40w1kqp1.js → index-zn9rh7sh.js}

@@ -79,6 +79,7 @@ ${sampleCleanup}## Akan Module Abstracts
 - Update the abstract when business invariants, workflows, or public behavior change.
 - Do not update the abstract for formatting-only, import-only, or style-only changes.
 - Service modules live in \`lib/_<service>\`, but their abstract file is \`<service>.abstract.md\`.
+- Keep an abstract short. Run \`akan compact <app-or-lib>\` to rewrite bloated abstracts down to the invariants the code cannot show; \`akan quality scan\` warns past 300 lines.
 
 ## Generated Files
 

package/index.js

@@ -17,20 +17,20 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-hq1x5605.js")).WorkspaceCommand,
-  agent: async () => (await import("./agent.command-ej4g9pbb.js")).AgentCommand,
-  application: async () => (await import("./application.command-smn51a28.js")).ApplicationCommand,
+  workspace: async () => (await import("./workspace.command-stv9g4a0.js")).WorkspaceCommand,
+  agent: async () => (await import("./agent.command-de4r6vk8.js")).AgentCommand,
+  application: async () => (await import("./application.command-nfsfm96y.js")).ApplicationCommand,
   library: async () => (await import("./library.command-68ah07a3.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-nmyc5vwv.js")).LocalRegistryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-84dz000g.js")).LocalRegistryCommand,
   package: async () => (await import("./package.command-00ncttab.js")).PackageCommand,
   module: async () => (await import("./module.command-t68xhamx.js")).ModuleCommand,
   page: async () => (await import("./page.command-1096s18n.js")).PageCommand,
   context: async () => (await import("./context.command-hhjyjtp7.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-2v7ga38h.js")).CloudCommand,
+  cloud: async () => (await import("./cloud.command-1qf95x67.js")).CloudCommand,
   guideline: async () => (await import("./guideline.command-vj956kfr.js")).GuidelineCommand,
   scalar: async () => (await import("./scalar.command-3kxy3fkh.js")).ScalarCommand,
   primitive: async () => (await import("./primitive.command-02eqpx6t.js")).PrimitiveCommand,
-  quality: async () => (await import("./quality.command-vap6xegb.js")).QualityCommand,
+  quality: async () => (await import("./quality.command-r9cageqb.js")).QualityCommand,
   repair: async () => (await import("./repair.command-7dynpnf1.js")).RepairCommand,
   workflow: async () => (await import("./workflow.command-yy0d9gk3.js")).WorkflowCommand
 };

package/{localRegistry.command-nmyc5vwv.js → localRegistry.command-84dz000g.js}

@@ -2,16 +2,16 @@
 import {
   CloudRunner,
   getNpmRegistryUrl
-} from "./index-j3j3qc9j.js";
+} from "./index-h5cvg9z9.js";
+import {
+  PackageScript
+} from "./index-z36qzgzp.js";
 import"./index-nsj2ftxj.js";
 import {
   ApplicationScript
-} from "./index-panyahn4.js";
+} from "./index-fbv96xaw.js";
 import"./index-76rn3g2c.js";
 import"./index-s9s0n5fz.js";
-import {
-  PackageScript
-} from "./index-z36qzgzp.js";
 import {
   Workspace,
   command,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.4.2-rc.2",
+  "version": "2.4.2-rc.3",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.4.2-rc.2",
+    "akanjs": "2.4.2-rc.3",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",

package/{quality.command-vap6xegb.js → quality.command-r9cageqb.js}

@@ -1,4 +1,7 @@
 // @bun
+import {
+  AbstractDoc
+} from "./index-0wae5ebk.js";
 import {
   Workspace,
   command,
@@ -87,6 +90,7 @@ var RULE_FIXES = {
   "akan.global.duplicate-exported-function-body": "Extract the shared implementation into a single exported helper and import it, instead of copying the body.",
   "akan.file.recommended-max-lines": "Split the file by responsibility \u2014 move Zones, Utils, or subcomponents into sibling files.",
   "akan.file.max-lines": "Break the file into smaller focused modules; keep one primary responsibility per file.",
+  "akan.file.abstract-max-lines": "Run `akan compact <app-or-lib>` to rewrite the abstract with the AI editor, keeping only the invariants and workflows the source files cannot show.",
   "akan.file.placeholder-export": "Remove the placeholder export; generated indexes should only re-export real modules.",
   "akan.file.dictionary-stale-text": "Replace the scaffold text with real localized copy for this dictionary entry.",
   "akan.file.global-declaration": "Move the global declaration into an approved low-level integration file (e.g. webkit) and keep it isolated.",
@@ -108,17 +112,19 @@ function getRuleFix(rule) {
 class AkanQualityScanner {
   async scan(workspaceRoot) {
     const targetFiles = await this.#collectTargetFiles(workspaceRoot);
-    const sourceFiles = await Promise.all(targetFiles.map((file) => this.#readSourceFile(workspaceRoot, file)));
+    const sourceFiles = await Promise.all(targetFiles.filter((file) => !AbstractDoc.isAbstractPath(file)).map((file) => this.#readSourceFile(workspaceRoot, file)));
+    const abstractFiles = await Promise.all(targetFiles.filter((file) => AbstractDoc.isAbstractPath(file)).map((file) => this.#readTextFile(workspaceRoot, file)));
     const warnings = [
       ...this.#scanGlobalQuality(sourceFiles),
       ...sourceFiles.flatMap((sourceFile) => this.#scanSingleFileQuality(sourceFile)),
       ...sourceFiles.flatMap((sourceFile) => this.#scanComponentQuality(sourceFile)),
       ...sourceFiles.flatMap((sourceFile) => this.#scanConventionQuality(sourceFile)),
-      ...sourceFiles.flatMap((sourceFile) => this.#scanLayoutQuality(sourceFile))
+      ...sourceFiles.flatMap((sourceFile) => this.#scanLayoutQuality(sourceFile)),
+      ...abstractFiles.flatMap((abstractFile) => this.#scanAbstractQuality(abstractFile))
     ];
     return {
       workspaceRoot,
-      scannedFiles: sourceFiles.length,
+      scannedFiles: sourceFiles.length + abstractFiles.length,
       warnings: warnings.map((warning) => ({ ...warning, fix: warning.fix ?? getRuleFix(warning.rule) })).sort(compareWarnings),
       suggestedRules: SUGGESTED_RULES
     };
@@ -153,6 +159,8 @@ class AkanQualityScanner {
       }
       if ((relativePath.endsWith(".ts") || relativePath.endsWith(".tsx")) && !relativePath.endsWith(".d.ts")) {
         files.push(relativePath);
+      } else if (AbstractDoc.isAbstractPath(relativePath)) {
+        files.push(relativePath);
       }
     }
   }
@@ -166,6 +174,9 @@ class AkanQualityScanner {
       sourceFile: ts.createSourceFile(file, content, ts.ScriptTarget.Latest, true, getScriptKind(file))
     };
   }
+  async#readTextFile(workspaceRoot, file) {
+    return { file, content: await readFile(path.join(workspaceRoot, file), "utf8") };
+  }
   #scanGlobalQuality(sourceFiles) {
     const exportedFunctionLikes = sourceFiles.flatMap((sourceFile) => getExportedFunctionLikes(sourceFile));
     const warnings = [];
@@ -304,6 +315,20 @@ class AkanQualityScanner {
     }
     return warnings;
   }
+  #scanAbstractQuality({ file, content }) {
+    const lineCount = AbstractDoc.lineCountOf(content);
+    if (lineCount <= AbstractDoc.maxLines)
+      return [];
+    return [
+      {
+        rule: "akan.file.abstract-max-lines",
+        scope: "file",
+        severity: "warning",
+        file,
+        message: `Abstract has ${lineCount} lines. Keep abstracts under ${AbstractDoc.maxLines} lines and compact them periodically.`
+      }
+    ];
+  }
   #scanLayoutQuality(sourceFile) {
     const segments = sourceFile.file.split("/");
     const warnings = [];

package/{workspace.command-hq1x5605.js → workspace.command-stv9g4a0.js}

@@ -6,7 +6,7 @@ import"./index-7ppn9v4n.js";
 import"./index-h971erkm.js";
 import {
   CloudScript
-} from "./index-majzj044.js";
+} from "./index-h6eav7zx.js";
 import"./index-z5v766nx.js";
 import"./index-acwxfncv.js";
 import"./index-04as43rp.js";
@@ -15,27 +15,27 @@ import"./index-ss469dec.js";
 import"./index-zfp1gz9f.js";
 import {
   AgentScript
-} from "./index-40w1kqp1.js";
+} from "./index-zn9rh7sh.js";
 import"./index-v9jqrdd1.js";
 import"./index-pfnh87f9.js";
 import"./index-xftstr5s.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-j3j3qc9j.js";
+} from "./index-h5cvg9z9.js";
+import {
+  PackageScript
+} from "./index-z36qzgzp.js";
 import {
   GlobalConfig
 } from "./index-nsj2ftxj.js";
 import {
   ApplicationScript
-} from "./index-panyahn4.js";
+} from "./index-fbv96xaw.js";
 import"./index-76rn3g2c.js";
 import {
   LibraryScript
 } from "./index-s9s0n5fz.js";
-import {
-  PackageScript
-} from "./index-z36qzgzp.js";
 import {
   Exec,
   Workspace,