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

package/index-9dp031by.js

@@ -0,0 +1,12 @@
+// @bun
+// pkgs/@akanjs/cli/openBrowser.ts
+import { spawn } from "child_process";
+function openBrowser(url) {
+  const command = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
+  const child = spawn(command[0], command.slice(1), { detached: true, stdio: "ignore" });
+  child.on("error", () => {});
+  child.unref();
+  return Promise.resolve();
+}
+
+export { openBrowser };

package/{index-ne2qy0nk.js → index-ahemdr5n.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-mak3cd28.js";
+} from "./index-w2zdcw3k.js";
 import {
   AGENT_BLOCK_START,
   AGENT_BLOCK_END,
@@ -13,17 +13,17 @@ import {
   CLAUDE_COMMENT_RULE,
   AppExecutor,
   LibExecutor
-} from "./index-2tv3fdx4.js";
+} from "./index-9d9bgcx4.js";
 import {
   collectRecipeSources2,
   scanRecipes2
-} from "./index-by5gpp8x.js";
+} from "./index-hj6w4ka1.js";
 import {
   AkanContextAnalyzer
-} from "./index-ktb5njgy.js";
+} from "./index-ygn77a5w.js";
 import {
-  Prompter
-} from "./index-h7yw2z9n.js";
+  Prompter2
+} from "./index-0bq14vr1.js";
 
 // pkgs/@akanjs/cli/agent/agent.script.ts
 import { Logger as Logger2 } from "akanjs/common";
@@ -106,10 +106,10 @@ ${scopeIndexPointer}
 `;
 };
 var renderGuides = async (context) => {
-  const conventions = (await Prompter.getInstruction("conventions")).trim();
+  const conventions = (await Prompter2.getInstruction("conventions")).trim();
   if (context.pkgs.some((pkg) => pkg.name === "akanjs"))
     return conventions;
-  const onboarding = (await Prompter.getInstruction("workspaceOnboarding")).trim();
+  const onboarding = (await Prompter2.getInstruction("workspaceOnboarding")).trim();
   const appName = context.apps[0]?.name ?? "app";
   return `${conventions}
 
@@ -117,7 +117,7 @@ ${onboarding.replaceAll("<%= appName %>", appName)}`;
 };
 var renderManagedBlock = async (workspace) => {
   const context = await AkanContextAnalyzer.analyze(workspace);
-  const frameworkGuide = await Prompter.getInstruction("framework");
+  const frameworkGuide = await Prompter2.getInstruction("framework");
   const appNames = context.apps.map((app) => app.name);
   const sampleCleanup = await renderSampleCleanup(workspace, appNames);
   const recipeIndex = await renderRecipeIndex(workspace);
@@ -126,7 +126,7 @@ var renderManagedBlock = async (workspace) => {
   const block = `## Workspace
 
 - Repo: ${context.repoName}
-- Apps: ${context.apps.map((app) => app.name).join(", ") || "none"}
+- Apps: ${appNames.join(", ") || "none"}
 - Libraries: ${context.libs.map((lib) => lib.name).join(", ") || "none"}
 - Packages: ${context.pkgs.map((pkg) => pkg.name).join(", ") || "none"}
 
@@ -138,7 +138,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.
+- Keep an abstract short \u2014 the invariants the code cannot show, and nothing it already states. \`akan quality scan\` warns past 300 lines.
 
 ## Generated Files
 
@@ -148,7 +148,7 @@ If generated output is stale or broken, update the owning source file and run \`
 ${recipeIndex}## MCP Workflow Policy
 
 - **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.
+- 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 three of the five repair tools \u2014 \`repair_generated\`, \`repair_imports\` and \`repair_module_shape\`. \`akan repair format\` and \`akan repair dictionary\` are CLI-only.
 - 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.

package/{index-ws5e0j51.js → index-as7xmyz8.js}

@@ -2,16 +2,16 @@
 import {
   runner,
   script
-} from "./index-mak3cd28.js";
+} from "./index-w2zdcw3k.js";
 import {
-  FileSys
-} from "./index-q0y2jq9j.js";
+  FileSys2
+} from "./index-5b6tavv3.js";
 import {
   PkgExecutor
-} from "./index-2tv3fdx4.js";
+} from "./index-9d9bgcx4.js";
 import {
   TypeScriptDependencyScanner2
-} from "./index-kcxmv48c.js";
+} from "./index-3t7g9e4r.js";
 
 // pkgs/@akanjs/cli/package/package.runner.ts
 import path2 from "path";
@@ -112,7 +112,7 @@ class PackageRunner extends runner("package") {
     "create-akan-workspace"
   ];
   async version(workspace, { log = true } = {}) {
-    const pkgJson = process.env.USE_AKANJS_PKGS === "true" ? await FileSys.readJson(`${workspace?.workspaceRoot ?? process.cwd()}/pkgs/akanjs/package.json`) : await this.#getInstalledPackageJson();
+    const pkgJson = process.env.USE_AKANJS_PKGS === "true" ? await FileSys2.readJson(`${workspace?.workspaceRoot ?? process.cwd()}/pkgs/akanjs/package.json`) : await this.#getInstalledPackageJson();
     const version = pkgJson.name === "akanjs" ? pkgJson.version : pkgJson.dependencies?.akanjs ?? pkgJson.version;
     if (log)
       Logger.rawLog(`akanjs@${version}`);
@@ -129,14 +129,19 @@ class PackageRunner extends runner("package") {
     for (const packageJsonPath of packageJsonCandidates) {
       if (!await Bun.file(packageJsonPath).exists())
         continue;
-      const packageJson = await FileSys.readJson(packageJsonPath);
+      const packageJson = await FileSys2.readJson(packageJsonPath);
       if (packageJson.name === "akanjs" || packageJson.name === "@akanjs/cli")
         return packageJson;
     }
     throw new Error(`[package] failed to locate akanjs package.json from ${path2.dirname(Bun.main)}`);
   }
   async createPackage(workspace, pkgName) {
-    await workspace.applyTemplate({ basePath: `pkgs/${pkgName}`, template: "pkgRoot", dict: { pkgName } });
+    const workspaceRootPath = ["pkgs", ...pkgName.split("/")].map(() => "..").join("/");
+    await workspace.applyTemplate({
+      basePath: `pkgs/${pkgName}`,
+      template: "pkgRoot",
+      dict: { pkgName, workspaceRootPath }
+    });
     await workspace.setPkgTsPaths(pkgName);
   }
   async removePackage(pkg) {
@@ -144,8 +149,7 @@ class PackageRunner extends runner("package") {
     await pkg.workspace.unsetPkgTsPaths(pkg.name);
   }
   async scanSync(pkg) {
-    const scanResult = await pkg.scan();
-    return scanResult;
+    return await pkg.scan();
   }
   async buildPackage(pkg) {
     await $`rm -rf ${pkg.dist.cwdPath}`;
@@ -153,7 +157,14 @@ class PackageRunner extends runner("package") {
     const scanner = await TypeScriptDependencyScanner2.from(pkg);
     const { npmDeps, npmDevDeps, missingDeps } = await scanner.getPackageBuildDependencies(pkg.name);
     const packageRuntimeDependencies = {
-      "@akanjs/devkit": ["tailwind-scrollbar"]
+      "@akanjs/devkit": [
+        "tailwind-scrollbar",
+        "@earendil-works/chord",
+        "@earendil-works/pi-agent-core",
+        "@earendil-works/pi-ai",
+        "@earendil-works/pi-telemetry",
+        "@earendil-works/pi-tui"
+      ]
     };
     const packageRuntimeDevDependencies = { akanjs: ["@biomejs/biome", "@types/bun"] };
     if (pkg.name === "@akanjs/cli") {
@@ -172,9 +183,14 @@ class PackageRunner extends runner("package") {
     const forcedRuntimeDevDeps = packageRuntimeDevDependencies[pkg.name] ?? [];
     const [rootPackageJson, pkgJson] = await Promise.all([pkg.workspace.getPackageJson(), pkg.getPackageJson()]);
     const optionalPeerDeps = new Set(Object.entries(pkgJson.peerDependenciesMeta ?? {}).filter(([, meta]) => meta.optional).map(([dep]) => dep));
-    const packageRuntimeDeps = [...new Set([...npmDeps, ...forcedRuntimeDeps])].filter((dep) => !optionalPeerDeps.has(dep) && !bundledRuntimeDeps.has(dep));
-    const packageRuntimeDevDeps = [...new Set([...npmDevDeps, ...forcedRuntimeDevDeps])].filter((dep) => !optionalPeerDeps.has(dep) && !bundledRuntimeDeps.has(dep));
-    const rootDeps = { ...rootPackageJson.dependencies, ...rootPackageJson.devDependencies };
+    const isShipped = (dep) => !optionalPeerDeps.has(dep) && !bundledRuntimeDeps.has(dep);
+    const packageRuntimeDeps = [...new Set([...npmDeps, ...forcedRuntimeDeps])].filter(isShipped);
+    const packageRuntimeDevDeps = [...new Set([...npmDevDeps, ...forcedRuntimeDevDeps])].filter(isShipped);
+    const rootDeps = {
+      ...rootPackageJson.overrides,
+      ...rootPackageJson.dependencies,
+      ...rootPackageJson.devDependencies
+    };
     const missingForcedDeps = forcedRuntimeDeps.filter((dep) => !rootDeps[dep]);
     const missingForcedDevDeps = forcedRuntimeDevDeps.filter((dep) => !rootDeps[dep]);
     const requiredMissingDeps = missingDeps.filter((dep) => !optionalPeerDeps.has(dep));
@@ -192,7 +208,8 @@ class PackageRunner extends runner("package") {
         stdio: "inherit"
       });
     } else {
-      await $`cp -r ${pkg.cwdPath}/. ${pkg.dist.cwdPath}`;
+      await pkg.dist.cp(pkg.cwdPath, pkg.dist.cwdPath);
+      await $`rm -rf ${pkg.dist.cwdPath}/local`;
       await Promise.all([
         pkg.generateDistPackageJson(packageRuntimeDeps, packageRuntimeDevDeps),
         pkg.generateTsconfigJson()
@@ -266,7 +283,7 @@ class PackageRunner extends runner("package") {
     if (!await Bun.file(distPackageJsonPath).exists()) {
       throw new Error(`[package] dist package not found for ${pkg.name}. Run build-package first.`);
     }
-    const pkgJson = await FileSys.readJson(distPackageJsonPath);
+    const pkgJson = await FileSys2.readJson(distPackageJsonPath);
     if (pkgJson.name !== pkg.name) {
       throw new Error(`[package] dist package name mismatch: expected ${pkg.name}, got ${pkgJson.name ?? "(missing)"}`);
     }
@@ -275,12 +292,9 @@ class PackageRunner extends runner("package") {
     if (pkgJson.publishConfig?.access !== "public") {
       throw new Error(`[package] ${pkg.name} must publish with publishConfig.access=public`);
     }
-    if (!await Bun.file(`${pkg.dist.cwdPath}/README.md`).exists()) {
-      throw new Error(`[package] README.md is missing from dist package ${pkg.name}`);
-    }
-    if (!await Bun.file(`${pkg.dist.cwdPath}/README.ko.md`).exists()) {
-      throw new Error(`[package] README.ko.md is missing from dist package ${pkg.name}`);
-    }
+    for (const readme of ["README.md", "README.ko.md"])
+      if (!await Bun.file(`${pkg.dist.cwdPath}/${readme}`).exists())
+        throw new Error(`[package] ${readme} is missing from dist package ${pkg.name}`);
     const binEntries = typeof pkgJson.bin === "string" ? [pkgJson.bin] : Object.values(pkgJson.bin ?? {});
     if (binEntries.some((binPath) => binPath.endsWith(".ts"))) {
       throw new Error(`[package] ${pkg.name} dist bin entries must not point at TypeScript sources`);
@@ -297,6 +311,9 @@ class PackageRunner extends runner("package") {
       cwd: pkg.workspace.workspaceRoot
     });
     const [packResult] = JSON.parse(packOutput);
+    const localFiles = (packResult?.files ?? []).filter((file) => file.path?.startsWith("local/"));
+    if (localFiles.length > 0)
+      throw new Error(`[package] ${pkg.name} would publish ${localFiles.length} test-run files under local/`);
     return {
       name: pkg.name,
       version: pkgJson.version,
@@ -313,9 +330,8 @@ class PackageRunner extends runner("package") {
       peerExportsMaps.set(pkg.name, await PackageExportsMap.from(pkg.dist.cwdPath));
     }
     const results = [];
-    for (const pkg of pkgs) {
+    for (const pkg of pkgs)
       results.push(await this.verifyDistPackage(pkg, { peerExportsMaps }));
-    }
     return results;
   }
   async#copyPackageReadmes(pkg) {