@akanjs/cli 3.0.0-beta.2 → 3.0.0-beta.21

package/tunnel.command-hsrv2mny.js

@@ -0,0 +1,129 @@
+// @bun
+import"./index-5b6tavv3.js";
+import {
+  GlobalConfig,
+  CloudApi
+} from "./index-22d57v4c.js";
+import {
+  Workspace,
+  runner,
+  script,
+  command
+} from "./index-rmcw8yc8.js";
+import {
+  AppExecutor
+} from "./index-ga6hygxr.js";
+import {
+  TunnelShare2
+} from "./index-smme4r47.js";
+import {
+  writeClipboard
+} from "./index-p6pbz9n5.js";
+
+// pkgs/@akanjs/cli/tunnel/tunnel.script.ts
+import { select } from "@inquirer/prompts";
+
+// pkgs/@akanjs/cli/tunnel/tunnel.runner.ts
+import { Logger } from "akanjs/common";
+import chalk from "chalk";
+class TunnelRunner extends runner("tunnel") {
+  async share(app, options) {
+    const spinner = app.spinning("Requesting a tunnel...");
+    const share = await TunnelShare2.open(app, {
+      ...options,
+      onLost: (reason) => Logger.rawLog(`tunnel disconnected (${reason}); reconnecting`, undefined, "error")
+    }).catch((error) => {
+      spinner.fail("Could not open the tunnel");
+      throw error;
+    });
+    spinner.succeed(`${app.name} is shared`);
+    const copied = await writeClipboard(share.url);
+    Logger.rawLog(`
+  ${chalk.bold(share.url)}${copied ? chalk.dim("  (copied)") : ""}`);
+    if (share.grant.expiresAt)
+      Logger.rawLog(chalk.dim(`  expires ${share.grant.expiresAt}`));
+    Logger.rawLog(chalk.dim(`  code ${share.grant.code} \u2014 stop it with: akan tunnel --stop ${share.grant.code}
+`));
+    await TunnelRunner.holdUntilInterrupt(() => share.close());
+  }
+  async list(workspace, host = GlobalConfig.akanCloudHost) {
+    const api = await CloudApi.fromHost(workspace, host);
+    const tunnels = await api.tunnelListInSelf();
+    if (!tunnels.length) {
+      Logger.rawLog("No tunnels are open.");
+      return;
+    }
+    for (const tunnel of tunnels)
+      Logger.rawLog(`${tunnel.connected ? chalk.green("\u25CF") : chalk.dim("\u25CB")} ${tunnel.code}  ${tunnel.url}` + `${tunnel.name ? `  ${chalk.dim(tunnel.name)}` : ""}` + `${tunnel.expiresAt ? chalk.dim(`  expires ${tunnel.expiresAt}`) : ""}`);
+  }
+  async stop(code, workspace, host = GlobalConfig.akanCloudHost) {
+    const api = await CloudApi.fromHost(workspace, host);
+    const stopped = await api.revokeTunnel(code);
+    if (stopped)
+      Logger.rawLog(`Stopped ${code}.`);
+    else
+      Logger.rawLog(`No tunnel named ${code} is open.`, undefined, "error");
+  }
+  static holdUntilInterrupt(onInterrupt) {
+    return new Promise((resolve) => {
+      let closing = false;
+      const stop = () => {
+        if (closing) {
+          Logger.rawLog("Abandoning the tunnel release; it will expire on its own.", undefined, "error");
+          process.exit(130);
+        }
+        closing = true;
+        onInterrupt().then(() => resolve());
+      };
+      process.on("SIGINT", stop);
+      process.on("SIGTERM", stop);
+    });
+  }
+}
+
+// pkgs/@akanjs/cli/tunnel/tunnel.script.ts
+class TunnelScript extends script("tunnel", [TunnelRunner]) {
+  static async resolveApp(workspace, name) {
+    const appNames = await workspace.getApps();
+    if (!appNames.length)
+      throw new Error("No apps found in this workspace (apps/<appName>/akan.config.ts)");
+    if (name && !appNames.includes(name))
+      throw new Error(`Unknown app: ${name}. Available: ${appNames.join(", ")}`);
+    if (name)
+      return AppExecutor.from(workspace, name);
+    const only = appNames.length === 1 ? appNames[0] : null;
+    if (only)
+      return AppExecutor.from(workspace, only);
+    return AppExecutor.from(workspace, await select({ message: "Select the app to share", choices: appNames }));
+  }
+  async share(name, { workspace, host, port, ttl }) {
+    const app = await TunnelScript.resolveApp(workspace, name);
+    await this.tunnelRunner.share(app, {
+      workspace,
+      ...host ? { host } : {},
+      ...port ? { port } : {},
+      ...ttl ? { ttlMinutes: ttl } : {}
+    });
+  }
+  async list(workspace, host) {
+    await this.tunnelRunner.list(workspace, host);
+  }
+  async stop(code, workspace, host) {
+    await this.tunnelRunner.stop(code, workspace, host);
+  }
+}
+
+// pkgs/@akanjs/cli/tunnel/tunnel.command.ts
+class TunnelCommand extends command("tunnel", [TunnelScript], ({ public: target }) => ({
+  tunnel: target({ desc: "Share a locally running app on a public URL" }).arg("app", String, { desc: "app to share", nullable: true }).option("list", Boolean, { desc: "list the shares this account is holding", default: false }).option("stop", String, { desc: "stop the share with this code", default: "" }).option("host", String, { desc: "host of the cloud", default: GlobalConfig.akanCloudHost }).option("port", Number, { desc: "local port to share (default: the app's dev port)", nullable: true }).option("ttl", Number, { desc: "minutes before the share expires", nullable: true }).with(Workspace).exec(async function(app, list, stop, host, port, ttl, workspace) {
+    if (list)
+      return await this.tunnelScript.list(workspace, host);
+    if (stop)
+      return await this.tunnelScript.stop(stop, workspace, host);
+    await this.tunnelScript.share(app, { workspace, host, ...port ? { port } : {}, ...ttl ? { ttl } : {} });
+  })
+})) {
+}
+export {
+  TunnelCommand
+};

package/{typeChecker-3xgrzc2v.js → typeChecker-px49mezc.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   TypeChecker2
-} from "./index-92zztqy1.js";
+} from "./index-dy0jx9ay.js";
 export {
   TypeChecker2 as TypeChecker
 };

package/typecheck.proc.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   TypeChecker2
-} from "./index-92zztqy1.js";
+} from "./index-dy0jx9ay.js";
 
 // pkgs/@akanjs/devkit/typecheck/typecheck.proc.ts
 import { Logger } from "akanjs/common";

package/workflow.command-z2p32nmf.js

@@ -0,0 +1,79 @@
+// @bun
+import {
+  Workspace,
+  script,
+  command
+} from "./index-rmcw8yc8.js";
+import"./index-5b6tavv3.js";
+import"./index-ga6hygxr.js";
+import"./index-hj6w4ka1.js";
+import"./index-yy4s1j72.js";
+import"./index-9629w7ns.js";
+import"./index-rnt66vym.js";
+import"./index-tgjy8xf3.js";
+import"./index-wp43xrjv.js";
+import"./index-ya5qbmyg.js";
+import"./index-pp54p5zk.js";
+import {
+  WorkflowRunner
+} from "./index-m0ms3n1c.js";
+
+// pkgs/@akanjs/cli/workflow/workflow.script.ts
+import { Logger } from "akanjs/common";
+class WorkflowScript extends script("workflow", [WorkflowRunner]) {
+  async workflow(action, workflow, inputs, {
+    format = "markdown",
+    out = null,
+    dryRun = false,
+    workspace
+  } = {}) {
+    if (action === "list") {
+      Logger.rawLog(this.workflowRunner.list({ format }));
+      return;
+    }
+    if (!workflow)
+      throw new Error(`Workflow name is required for "${action}".`);
+    if (action === "explain") {
+      Logger.rawLog(this.workflowRunner.explain(workflow, { format }));
+      return;
+    }
+    if (action === "plan") {
+      Logger.rawLog(await this.workflowRunner.plan(workflow, inputs, { format, out }));
+      return;
+    }
+    if (action === "apply") {
+      if (!workspace)
+        throw new Error("Workspace is required for workflow apply.");
+      const registry = WorkflowRunner.stepRegistry(workspace);
+      Logger.rawLog(await this.workflowRunner.apply(workflow, { dryRun, format, workspace, registry }));
+      return;
+    }
+    if (action === "validate") {
+      if (!workspace)
+        throw new Error("Workspace is required for workflow validate.");
+      Logger.rawLog(await this.workflowRunner.validate(workflow, { format, workspace }));
+      return;
+    }
+    if (action === "report") {
+      if (!workspace)
+        throw new Error("Workspace is required for workflow report.");
+      Logger.rawLog(await this.workflowRunner.report(workflow, { format, workspace }));
+      return;
+    }
+    throw new Error(`Unknown workflow action: ${action}. Use list, explain, plan, apply, validate, or report.`);
+  }
+}
+
+// pkgs/@akanjs/cli/workflow/workflow.command.ts
+class WorkflowCommand extends command("workflow", [WorkflowScript], ({ public: target }) => ({
+  workflow: target({ desc: "List, explain, plan, apply, validate, or report Akan workflows" }).arg("action", String, {
+    desc: "list, explain, plan, apply, validate, or report",
+    enum: ["list", "explain", "plan", "apply", "validate", "report"]
+  }).arg("workflow", String, { desc: "workflow name, plan path, or run id", nullable: true }).with(Workspace).option("format", String, { desc: "output format", flag: "o", default: "markdown", enum: ["markdown", "json"] }).option("out", String, { flag: "w", desc: "write workflow plan JSON to this path", nullable: true }).option("dryRun", Boolean, { flag: "r", desc: "show predicted apply report without writing files", default: false }).option("app", String, { desc: "target app or library name", nullable: true }).option("module", String, { desc: "target module name", nullable: true }).option("field", String, { desc: "field name", nullable: true }).option("type", String, { desc: "field type or scalar name", nullable: true }).option("values", String, { flag: "l", desc: "comma-separated values", nullable: true }).option("default", String, { desc: "default value", nullable: true }).option("scalar", String, { flag: "c", desc: "scalar name", nullable: true }).option("surface", String, { flag: "u", desc: "UI surface name", nullable: true }).option("mutation", String, { flag: "n", desc: "mutation name", nullable: true }).option("slice", String, { flag: "i", desc: "slice name", nullable: true }).exec(async function(action, workflow, workspace, format, out, dryRun, app, module, field, typeName, values, defaultValue, scalar, surface, mutation, slice) {
+    await this.workflowScript.workflow(action, workflow, { app, module, field, type: typeName, values, default: defaultValue, scalar, surface, mutation, slice }, { format, out, dryRun, workspace });
+  })
+})) {
+}
+export {
+  WorkflowCommand
+};

package/{workspace.command-8s050m0h.js → workspace.command-tmdqkrh0.js}

@@ -1,28 +1,28 @@
 // @bun
 import {
-  FileSys
-} from "./index-q0y2jq9j.js";
+  FileSys2
+} from "./index-5b6tavv3.js";
 import {
   GlobalConfig
-} from "./index-kn1h7p1x.js";
+} from "./index-22d57v4c.js";
 import {
   Exec,
   Workspace,
   runner,
   script,
   command
-} from "./index-mak3cd28.js";
+} from "./index-rmcw8yc8.js";
 import {
   extractAgentBlock,
   collectScopeRecipeSources,
   renderScopeAgentBlock,
+  Linter,
   WorkspaceExecutor,
   SysExecutor,
   AppExecutor,
   LibExecutor,
   PkgExecutor
-} from "./index-2tv3fdx4.js";
-import"./index-6wwzs1bc.js";
+} from "./index-ga6hygxr.js";
 import {
   countBlocking,
   formatStyleContract,
@@ -31,42 +31,44 @@ import {
 import {
   collectRecipeSources2,
   scanRecipes2
-} from "./index-by5gpp8x.js";
-import"./index-gyd220p2.js";
-import"./index-ktb5njgy.js";
-import"./index-h7yw2z9n.js";
+} from "./index-hj6w4ka1.js";
+import"./index-yy4s1j72.js";
+import"./index-9629w7ns.js";
+import"./index-0bq14vr1.js";
 import {
   AgentScript
-} from "./index-ne2qy0nk.js";
-import {
-  ApplicationScript
-} from "./index-v0qh106m.js";
+} from "./index-4dn1p115.js";
+import"./index-khpfpcsd.js";
 import {
   LibraryScript
-} from "./index-259dsnz3.js";
-import"./index-hwkygn9s.js";
-import"./index-kcxmv48c.js";
+} from "./index-1db2cw0y.js";
+import {
+  ApplicationScript
+} from "./index-z50k041j.js";
+import"./index-hr5n7t4x.js";
+import"./index-7md2g9vw.js";
+import"./index-3t7g9e4r.js";
 import {
   PackageScript
-} from "./index-ws5e0j51.js";
+} from "./index-mgfx3mfs.js";
 import {
   getNpmRegistryUrl,
   getLatestPackageVersion
-} from "./index-2hq52jq3.js";
+} from "./index-yjkte9aj.js";
 import {
-  CloudScript
-} from "./index-zry5nz81.js";
+  CloudScript2
+} from "./index-8kb5p54p.js";
+import"./index-dg97qp24.js";
+import"./index-ya5qbmyg.js";
+import"./index-rnt66vym.js";
+import"./index-tgjy8xf3.js";
+import"./index-wp43xrjv.js";
+import"./index-pp54p5zk.js";
+import"./index-m0ms3n1c.js";
 import {
   ContextScript
-} from "./index-600zhnve.js";
-import"./index-wt7qrtd4.js";
-import"./index-fz5q3gd7.js";
-import"./index-7737gxcp.js";
-import"./index-8pm30m73.js";
-import"./index-pnqbkf5p.js";
-import"./index-4edzf1gr.js";
-import"./index-rwg2aa4f.js";
-import"./index-j9yhg404.js";
+} from "./index-7cqjvraf.js";
+import"./index-q44jbw48.js";
 
 // pkgs/@akanjs/cli/workspace/workspace.runner.ts
 import path from "path";
@@ -95,29 +97,15 @@ var defaultMaxDiagnostics = 200;
 class WorkspaceRunner extends runner("workspace") {
   async generateAgentRules(workspace, { overwrite = false, cursorRules = true } = {}) {
     const [appNames] = await workspace.getExecs();
-    const dict = {
-      repoName: workspace.repoName,
-      appName: appNames[0] ?? "app"
-    };
-    const created = await workspace.applyTemplate({
-      basePath: ".",
-      template: "workspaceRoot/AGENTS.md.template",
-      dict,
-      overwrite
-    });
-    created.push(...await workspace.applyTemplate({
-      basePath: ".",
-      template: "workspaceRoot/CLAUDE.md.template",
-      dict,
-      overwrite
-    }));
-    if (cursorRules)
-      created.push(...await workspace.applyTemplate({
-        basePath: ".cursor/rules",
-        template: "workspaceRoot/.cursor/rules/akan.mdc.template",
-        dict,
-        overwrite
-      }));
+    const dict = { repoName: workspace.repoName, appName: appNames[0] ?? "app" };
+    const templates = [
+      [".", "workspaceRoot/AGENTS.md.template"],
+      [".", "workspaceRoot/CLAUDE.md.template"],
+      ...cursorRules ? [[".cursor/rules", "workspaceRoot/.cursor/rules/akan.mdc.template"]] : []
+    ];
+    const created = [];
+    for (const [basePath, template] of templates)
+      created.push(...await workspace.applyTemplate({ basePath, template, dict, overwrite }));
     return created;
   }
   async createWorkspace(repoName, appName, {
@@ -180,57 +168,47 @@ class WorkspaceRunner extends runner("workspace") {
     return Object.fromEntries(Object.entries(dependencyVersions).filter(([dependency]) => defaultWorkspacePeerDependencies.has(dependency)));
   }
   async#getCliPackageJson() {
-    const packageJsonCandidates = [
+    const found = await this.#findPackageJson("@akanjs/cli", [
       path.join(import.meta.dir, "../package.json"),
       path.join(import.meta.dir, "package.json"),
       path.join(path.dirname(Bun.main), "package.json")
-    ];
-    try {
-      packageJsonCandidates.unshift(Bun.resolveSync("@akanjs/cli/package.json", import.meta.dir));
-    } catch {}
-    for (const packageJsonPath of packageJsonCandidates) {
-      if (!await Bun.file(packageJsonPath).exists())
-        continue;
-      const packageJson = await FileSys.readJson(packageJsonPath);
-      if (packageJson.name === "@akanjs/cli")
-        return packageJson;
-    }
-    return { name: "@akanjs/cli", version: "0.0.0", description: "@akanjs/cli" };
+    ]);
+    return found ?? { name: "@akanjs/cli", version: "0.0.0", description: "@akanjs/cli" };
   }
   async#getAkanPackageJson() {
-    const packageJsonCandidates = [
+    const ancestors = [];
+    for (let current = import.meta.dir, depth = 0;depth < 6; depth++) {
+      ancestors.push(path.join(current, "package.json"));
+      if (path.dirname(current) === current)
+        break;
+      current = path.dirname(current);
+    }
+    const found = await this.#findPackageJson("akanjs", [
       path.join(import.meta.dir, "../../../akanjs/package.json"),
       path.join(process.cwd(), "pkgs/akanjs/package.json"),
-      path.join(path.dirname(Bun.main), "node_modules/akanjs/package.json")
-    ];
+      path.join(path.dirname(Bun.main), "node_modules/akanjs/package.json"),
+      ...ancestors
+    ]);
+    if (!found)
+      throw new Error(`[workspace] failed to locate akanjs package.json from ${import.meta.dir}`);
+    return found;
+  }
+  async#findPackageJson(name, candidates) {
     try {
-      packageJsonCandidates.unshift(Bun.resolveSync("akanjs/package.json", import.meta.dir));
+      candidates.unshift(Bun.resolveSync(`${name}/package.json`, import.meta.dir));
     } catch {}
-    for (const packageJsonPath of packageJsonCandidates) {
+    for (const packageJsonPath of candidates) {
       if (!await Bun.file(packageJsonPath).exists())
         continue;
-      const packageJson = await FileSys.readJson(packageJsonPath);
-      if (packageJson.name === "akanjs")
+      const packageJson = await FileSys2.readJson(packageJsonPath);
+      if (packageJson.name === name)
         return packageJson;
     }
-    let current = import.meta.dir;
-    for (let depth = 0;depth < 6; depth++) {
-      const packageJsonPath = path.join(current, "package.json");
-      if (await Bun.file(packageJsonPath).exists()) {
-        const packageJson = await FileSys.readJson(packageJsonPath);
-        if (packageJson.name === "akanjs")
-          return packageJson;
-      }
-      const parent = path.dirname(current);
-      if (parent === current)
-        break;
-      current = parent;
-    }
-    throw new Error(`[workspace] failed to locate akanjs package.json from ${import.meta.dir}`);
+    return null;
   }
   async lint(exec, workspace, { fix = true, maxDiagnostics = defaultMaxDiagnostics } = {}) {
     const configPath = await WorkspaceRunner.resolveBiomeConfigPath(workspace);
-    await workspace.spawn("./node_modules/.bin/biome", [
+    await workspace.spawn(`./node_modules/.bin/${Linter.biomeBinName}`, [
       "check",
       ...fix ? ["--write"] : [],
       "--no-errors-on-unmatched",
@@ -327,7 +305,7 @@ class WorkspaceScript extends script("workspace", [
   ApplicationScript,
   LibraryScript,
   PackageScript,
-  CloudScript,
+  CloudScript2,
   ContextScript,
   AgentScript
 ]) {
@@ -438,10 +416,13 @@ class WorkspaceScript extends script("workspace", [
 }
 
 // pkgs/@akanjs/cli/workspace/workspace.command.ts
+var maxDiagnosticsOption = {
+  desc: "How many diagnostics Biome prints before truncating (0 for no limit)",
+  default: defaultMaxDiagnostics
+};
+
 class WorkspaceCommand extends command("workspace", [WorkspaceScript], ({ public: target }) => ({
-  createWorkspace: target({ desc: "Create a new Akan.js workspace", runsOnWorkspaceRoot: false }).arg("workspaceName", String, { desc: "what is the name of your organization?" }).option("app", String, {
-    desc: "what is the codename of your first application? (e.g. myapp)"
-  }).option("dir", String, {
+  createWorkspace: target({ desc: "Create a new Akan.js workspace", runsOnWorkspaceRoot: false }).arg("workspaceName", String, { desc: "what is the name of your organization?" }).option("app", String, { desc: "what is the codename of your first application? (e.g. myapp)" }).option("dir", String, {
     desc: "directory of workspace",
     default: process.env.USE_AKANJS_PKGS === "true" ? "local" : "."
   }).option("libs", Boolean, {
@@ -454,17 +435,10 @@ class WorkspaceCommand extends command("workspace", [WorkspaceScript], ({ public
       }
     ],
     default: false
-  }).option("init", Boolean, {
-    desc: "Do you want to initialize the workspace? (Recommended)",
-    default: true
-  }).option("registry", String, {
+  }).option("init", Boolean, { desc: "Do you want to initialize the workspace? (Recommended)", default: true }).option("registry", String, {
     desc: "npm registry URL for installing Akan packages",
     default: process.env.AKAN_NPM_REGISTRY ?? "https://registry.npmjs.org"
-  }).option("owner", String, {
-    desc: "owner of the workspace",
-    default: process.env.GITHUB_OWNER,
-    nullable: true
-  }).option("mcpInstall", Boolean, {
+  }).option("owner", String, { desc: "owner of the workspace", default: process.env.GITHUB_OWNER, nullable: true }).option("mcpInstall", Boolean, {
     desc: "Install the Akan MCP server config for Cursor, Claude Code, and Codex? (Recommended)",
     default: true
   }).option("agentInstall", Boolean, {
@@ -488,16 +462,10 @@ class WorkspaceCommand extends command("workspace", [WorkspaceScript], ({ public
   }).option("overwrite", Boolean, { desc: "Overwrite existing agent rule files", default: false }).option("cursorRules", Boolean, { desc: "Generate .cursor/rules/akan.mdc", default: true }).with(Workspace).exec(async function(overwrite, cursorRules, workspace) {
     await this.workspaceScript.generateAgentRules(workspace, { overwrite, cursorRules });
   }),
-  lint: target({ desc: "Lint and fix code in a specific app/lib/pkg" }).with(Exec).option("fix", Boolean, { default: true }).option("maxDiagnostics", Number, {
-    desc: "How many diagnostics Biome prints before truncating (0 for no limit)",
-    default: defaultMaxDiagnostics
-  }).with(Workspace).exec(async function(exec, fix, maxDiagnostics, workspace) {
+  lint: target({ desc: "Lint and fix code in a specific app/lib/pkg" }).with(Exec).option("fix", Boolean, { default: true }).option("maxDiagnostics", Number, maxDiagnosticsOption).with(Workspace).exec(async function(exec, fix, maxDiagnostics, workspace) {
     await this.workspaceScript.lint(exec, workspace, { fix, maxDiagnostics });
   }),
-  lintAll: target({ desc: "Lint and fix code in all apps and libraries" }).option("fix", Boolean, { default: true }).option("maxDiagnostics", Number, {
-    desc: "How many diagnostics Biome prints before truncating (0 for no limit)",
-    default: defaultMaxDiagnostics
-  }).with(Workspace).exec(async function(fix, maxDiagnostics, workspace) {
+  lintAll: target({ desc: "Lint and fix code in all apps and libraries" }).option("fix", Boolean, { default: true }).option("maxDiagnostics", Number, maxDiagnosticsOption).with(Workspace).exec(async function(fix, maxDiagnostics, workspace) {
     await this.workspaceScript.lintAll(workspace, { fix, maxDiagnostics });
   }),
   syncAll: target({ desc: "Sync dependencies and configuration for all apps and libraries" }).with(Workspace).exec(async function(workspace) {

package/abstractCompactor-mjh5ppsq.js

@@ -1,101 +0,0 @@
-// @bun
-import"./index-q0y2jq9j.js";
-import {
-  AiSession
-} from "./index-kn1h7p1x.js";
-import {
-  AbstractDoc
-} from "./index-meh558jy.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
-};